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Intr odu.c t i on 


R e rn e rn b 0 r ? D 0 N T F‘ A NIC* T h i s i s t h 0 n 0 w * 1 rn p r o v 0 d 3. n t r o d u c: — 
t i o n 1 : o t hi 0 H i t c h hi i k 0 r s 8 u i d 0 t o t h © B 10 8 H w h i c: h d © s c r i b e s 
t. h 0 B 10 S i. a n d rn a n y o t h e r a s p © c t s > o f A t a r i s 8 T c o rn p u t0 r 
s e r i e s« T h e i n t r o c:i u c. t i o n st i ]. 1 w o n t t e 1 1 y o u rn u c: h «, b u t a t 
I e a 15 1 i t 1 0 11 s y o u n o t t o p a n i. c , 

T h © 6 u i d 0 0 i n t © n d 0 d a u d i. © n c: 0 s 

A p p 1 i c: a t i o n w r :L 1 0 r s (w h o w i 11 f x n d s o rn 0 o t t h 0 f u n c ~ 
t x o n s a n d h i n t s h © r 0 1 n v a 1 u a b 1 0 ) ;; 

Those wishing to make use of some of the ST s 
h a r d w a r © - s p 0 c i f i c. f 0 a t u. r 0 s i h a c k i n q p a i e 11 0 c o 1 o r s «« 
c o n f i. q u. r i n g t h e R S 232 p o r t „ a n d s o o n ; 5 

T hi o s 0 w r i t i n q d 0 v i c 0 d r i v 0 r s n v i d 0 o q a m 0 s, o r 

c: a r t r i d g 0 - h a s 0 d a p* p X i c a 1 1 o n s 

T hi © hi ai t u a i i y c u r i o u s ( i n c 1 u c:i i n q t r i v :i. a t r i p p 0 r s H 
i n f o r rn a t i. o n . j u. n k i © s a n d d >0 c u rn © n t a t i o n a d d 3. c t s ) . 


F o r rn a n y r 0 a s o n s t hi i s h o u I d s t i i 1 b © c o n s i d © r 0 d a p r 0 i i m. 

i n a r y d o c u m e n t« A w h o !i. © h a s t o f t h i n g ns r 0 m a i n u n d o c u m 0 n t © d 
many GEMDOS issues have not even been approached by our 
f r i 0 n d i:s a t D i g i t a i R © s 0 a r c h «, a n d t h 0 r © a r 0 a / w h o 1 0 1 o t / o f 
f 0 a t u r 0 s w & cl 1 ;i. k e t o a c j d t o t h 0 s o f t w a r 0 » 
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GEMDOS BIOS Ca11a ; 

Description 
and 

D e v i a t i o n f r o rn t h © G E M D 0 S S p © c 


The ST B10S , contrary to th© 8EMD0S ap ec:i f i c:ation , is ca 11 — 
a b I e f {-• q rn t h © 68 0 00 ” a u s © r m o d © 

T h © B10 S i a r e — e n t r a n t t o t h r e e I e v e 1 s „ T h a t i a , t h e r e m a y 
b © up 1 o t h r ee r ec ur a i ve BI OS c a 11 s b ©f or © t h e sy st em r un s 
i n t o t r o u b 1 e « M a I © v © 1 c h e c k i n g i a p © r f o r m © d; t h © f i r a t 
a i q n o f a n o v e r f I o w w i 11 b e m y a t © r i o u s s y a t © rn b © h a v i o r , a n d 
a n © v © n t u a 1 c r a a h« 

A p pile a t i o n s a h o u i d N 0 T a 11 e rn p t d i a k o r p r i n t © r I / 0 C t h i s 
i n c I u d © a g © t b p b c a 11 a , a n d s t a n d a r d - o u t p u t r e d i r e c t e d t o t h e 
p r i n 1 e r d e v i c ©) i n c r i t i c a 1 - © r r o r „ a y s t © rn t i m e r o r p r o c © a s - 
t © r m i n a t e h a n d, I © r a „ 


NOTE 

The BIOS modifies the function number (and., the re- 
t u r n a d d r © a a) p u a h © d o n t ii © s t a c k b y t h © a p p 1 i c: a ••••• 
t i o n „ T h © f u n c t i o n n u m b © r o n t h e a t a c k w i 1 i. b © Z E R 0 
o n r © t u r n « L F o r t h © c u r i o u a s t h i a f e a t u r © a a v © d 
a © v e r a 1 c: y c 1 © a p © r B10 S c a 11 « « « J 


( 0 ) 


getmpb 

V 01D g e t m p b p rn p b ) 

LONG p.mph; 

U p o n © n t r y ,, p.rn p h p o i n t a t o a a i z © o f < N P B) 

b 1 o c k t o b e? f i 11 © d i n w i t h t h e s y a t e m i n i t i a 1 
H © m o r y P a r a rn e t e r B1 o c k« U p o n r © t u r n H t h © l v l P 3 i a 
f i11 ©d in « 


S t r li c 1 li r e a a r e 

# d e f i n e !i i :::, B a t r u c t rn p b 

# d © f i n © h D a t r u c t rn d 


A t a r i C o r p « C o n f i ci © n 1 1 a I 
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# d e f i n e P D s t r u c t p d 

HP8 i 

M D * rn p.m f I ;; / * rn e m o r y f r e © 1 i s t * / 

M D * rn p.rn a I ; / * rn e m o r y a 11 o c a t e d 1 i s t * / 

H D * rn p _ r o v e r ; / * r o v i n q p t r * / 

MD 1 

HD * fn link; /•* next HD (or HULL) */ 

1 o n g m s t a r t ; / * s a d d r o f b I o c: k * / 

1 onq rn.1 enqth ; /* #bytes i n b I oc k •*/ 

P D m o w n ; / * o w n e r s p r o c e s s d © s c r i p t o r * / 


C S e e S y s t e rn V a r i a b i e s f o r rn o r e i n f o r rn a t i o n 

a b o u. t s 0 11 i n g u p t h e i n i t i a 1 T P A . 2 

i 1 ) boonstat 

W 0 R D b c o n © t a t (d © v) 

WORD dev; 

R e t u r n c: h a r a c t e r • • d e v i c e i n p u. t s t a t u s,, D 0« L w i 11 

b e 0000 i f n o c h a. r a c t © r s a v a i I a b 1 e , o r f f 11 :i. f 

(a t I e a s t o n e) c h a r a c: t e r i s a v a i 1 a b 1 e« d e v c a n 

be one of 2 

0 P R T 5 < p r i n t © r ,, t h e p a r a 11 © i p o r t) 

1 A U X s (a Li k d e v i c e , t h e R8232 p o r t ) 

2 C 0 N 2 < c o n s o 1 0 . t t h e s c r 0 e n) 

3 HIDI p o r t < A t a r i © k t e n s i o n ) 

4 K e y h c::« a r d p o r t (A t a r i 0 x 1 0 n s i o n ) 

L e g a I o p 0 r a t i. o n s o n c h a r a c 1 0 r d 0 v ice s a r 0 2 



1 0 ) 

< i) 

< 2) 

< 3) 

< 4 > 

□peration 

PR T 

AUX 

COM 

HIDI 

KBD 

bconstat (> 

n 0 

yes 

yes 

yes 

n 0 

Id coni n ) 

yes 

yes 

yes 

yes 

no 

beonout (; 

yes 

0 s 

yes 

y e s 

yes- 

boostat () 

yes 

y © s 

yes 

yes 

yes 


( 2 ) boonin 

W 0 R D b c o n i n (d © v) 

WORD dev; 

d 0 v i s t h e c h a r a c 1 0 r d 0 v i c 0 n u m b 0 r d 0 s c r i b © d i n 
f unct i on :l. „ 

Do0s not r©turn u.nt i i a character has be©n 1 nput 
(busy-wait)« It returns the character value in 

Atar1 Corp« Confidentia 1 
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D 0«, L « w i t h t h e h i g h w o r d z e r o« 

F o r t h 0 c o n s o 1 e (C O W s , d e v i c e 2) i t r e t u r n s t h e 
IB l Y l •“ P C c: o m p a. t i b I e s c a n c o d e i n t hi e 1 o w b y t e o t t h e 
u p p © r w o r d n a n d t hi e A s c i i c: h a r a c:: ter i n t h e 1 o w 
b y t e o f t h e i o w w o r d . 

I f b i t 3 i n t h © s y s t © rn v a r i a b 1 e e o n t © r m i s s © t, 
then the high byte of the upper word will contain 
t hi e v a 1 u © o f t h e s y s t © rn v a r i a b 1 e k b s h i f t f o r 
that keystroke. CThe default state for con™ 
t e r rn % % 3 ' i s 0 F F „ 1 


<3) beonout 

V 01D b c o n o u t (c:i © v „ c ) 

WORD dev, c:;; 

d e v i s t h e c hi a r a c t e r d e v i c e n u m b e r d e s c: r i b © d i n 
function 1« 

0 u t p u t c h a r a c: t e r c t o t h e d e v ice,, D o e s n o t 
r e t u r n u n t i 1 t h e c h a r a c t e r h a s b e e n w r i 11 e n. 


(4) rwabs 

L 0 N (3 r w a b s (r w f 1 a q 9 b u f , o o u n t , r e c n o, d e v ) 

WORD rwf1ag§ 

LONG but; 

W 0 R D c o u n t ,, r e c n o H d © v; 

R e a d o r w r i t e 1 o g i c a i s e e t o r s o n a d © v i c to „ 

rwf1ag is one ofs 

0 read 

1 write 

2 r e a d H d o n o t a f i : e c t m © d i a - c: h a n g e 

3 w r i t e , d o n o t a f f e c t m e d l a - c h a n g e 


h u f p o i n t s t o a b ti 1 : f © r t o r e a d o r w r 1 1 © t o 

(ix n a 1 i g n e d t r a n s f e r s — o n o d d b o u n d a r i e s .- a r © 

p e r rn i 11 e d , b u t t h e y a r e i*» 1 o w) » c o u n t i s t h e 

n u. rn b e r o f s e c t o r s t o t r a n s f e r « r e c n o i s t h e 
1 o q i c a i s e c t o r n u rn b e r t o s t a r t t h e t r a n s t © r a t 
dev is the device number, and on the ST is one 
of s 

0 F1 o p p y d r i v © A s 

1 Floppy drive Bs lor “logical" drive A 
o n s i n q i e - d i s k s y s t e m s > » 

2 1 - H a r d d i s k s,, n e t w o r k s , e t c . 


0 n r e t u r n , 0 L i n d i c a t © s a s u c: c e s s f u 1 o p e r a t i o n 

A n y n e q a t i v e n u m b e r i n d i c a t e s a n e r r o r c o n d 1 1 x o n „ 

( i t i s t h e r e s p o n s i b i i i t y o f t h e B10 S t o d e t e c: t 


A t a r i C o r p ,, C o n f i d e n t i a 1 
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rn 0 d i a c: h a n q 0 s , a n d r e t u r n t h 0 ax p p r o p r 1 a t e 0 r r o r 
code) * 

11 o d 0 s 2 a n d 3 f o r c 0 a p h y s i c a I d i s k o p e r a 1 1 0 n 
that will NOT affect media change, nor result in 
0 n e < thi s a 11 0 w 0 t h e 6E11D08 d i s k f 0 r ma 11 er n f 0 r 
1 n st an ce , t o r ead an d wr i 1 0 i oq i c a 1 sec t or s at t er 
t : o r m a 111 n g a d i s k , a n d s 1111 a 11 0 w t h e B10 S 1 0 

recognize a media change on the volume just for. 

matted),, 


[ e x p I a i n a h 0 u t ‘ 5 i n s 0 r t ••• d :i. s k 1 * c r i 11 c a I 0 r r 0 r h a c k 

f o r s i n g 1 0 - d r i v e s y s 1 0 rn s 3 


(5) setexc 

L 0 N (3 s 0 1 0 x c (v e c n u m h v e c ) 

W 0 ft D v e c n u m 5 
LONG vec; 

v 0 c n u rn i s t h e n u rn b 0 r 0 f t h e v 0 c t o r 10 g 01 0 r 

s e t« v e c i s t h e a d d r e s s t o s e t u p i n t h e v e c t a r 

s 1 01 r, n o s 01 1 s d 0 n e i f v 0 c i s ~ 1 L.. T h 0 

v e c 10 r s p r e v 1 o u s v a 1 u e i s r e t u r n e d« 

V 0 c 10 r s $ 0 0 t h r 0 u g h $ F P" a r 0 r 0 s e r v 0 d f 0 r t h e 
68000« 

Logical vectors $100 through $1FF are reserved 
•f o r 8 E H D 0 8 „ V e c 1 0 r s c u r r 0 n t1 y 3 . m p 1 e m e n t e d a r e 2 

$ 1 0 0 S y s t e rn t i rn 0 r i n t e r r u p t 

$ 10 1 C r i t i c a 1 e r r o r h a n d 1 e r 

$ 10 2 P r 0 c 0 s s 1 0 r m i n a t e h 0 0 k 

$ j. 0 3« « $ 10 7 s C u r r e n 1.1 y u. n u s e d , r 0 s e r v e d 


L 0 g i cr. a i v 0 c t o r s $200 t h r 0 u g h $ F P F r F' a r 0 r 0 s 0 r v 0 d 
■f o !•- 0 E M u s e « T h e S T B10 8 m a k e s n o p r o v 3 . s i o i"i f 0 r 

these,, 

(6 > t i. c k c a I 

LONG tickcal () 

ft 0 1 u r n 0 a s y s 1 0 m *•-1 i rn 0 r* c a 1 i b r a t i 0 n v a 1 u 0 n 1 0 t hi 0 
n e a r e s t m i 1 i i si e c o n d « 

T hi :i. s i sh. a s i i I y f u. n c t i 0 n , s i n c: 0 t h 0 n u rn b« e r 0 f 
0 1 a p s e d rn i 11 i s e c o n d s i s p a s s e d o n t h e ns t a c k d u r - 
1 n g a s y s 1 0 m ~ t i m 0 r t r a p ,, 


(7) *getbpb 

B P B * g 0 1 b p b (d 0 v ) 

WORD dev; 

dev is a device number (0 for drive A H etc») 
ft e t u r n s a p o i n t e r t o t h e B10 S P a r a m e t e r B1 0 c k f 0 r 


Atari Corp 


CentidentiaI 
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the spec:i t i ecl dr :i vos „ or 0 L i t (tor some reaison > 

t h e B P B c: a n n o t b e d e t e r rn i n e cl. 

(8) beastat 

LONG hcostat(dev) 

d e v i s a c h a r a c t e r d e v i c: e n u m b e r H a s i n t u n c 

t i o n 1 „ R e t u r n s c h a r a c t e r o u t p u. t s t a t u s 2 


J. D os v i c e i s r e a d y t o 0 e n d (n o w a i t i n g a n 
n os x t d 0 v i c 0 ~ a u t p u t c a i 1 ) 

0 Q 0 v i c: os 1 s n o t r 0 a d y t o s 0 n d» 


i 9 ) med 1 ach 

L 0 N 6 rn 0 d i a c h (ci os v > 

WORD dev; 

d os v i s a. d r i v 0 n u m b 0 r « R 0 1 u r n s o n 0 o 1 2 

0 li 0 d :i a d 0 1 i n i t os I y h a s n o t c h a n q 0 d 

1 li 0 d i a / m :i. g h t / h a v 0 c h a n g os d 

2 !i 0 d i a d 0 1 i n i 1 0 1 y h a s c h a n g os ci 

8E li D 0 S w i 11 r 0 s p o n d t o a r 0 1 u r n v a 1 u. 0 o f i w i t h 

a r «s a o:i a p os r a t :i. o n „ 11 t h 0 B10 8 d 0 1 os c i s a n a h s o - 

I u 1 0 rn 0 d i a c: h a n q 0 i t w 111 r 0 1 u r n a 1 s m 0 d i a 

c: h a n g 0 n os r r a r a t t h a t t .i rn 0 „ 


( 10 ) drvmap 

LONG drvmap() 

R os t ix r n s a b 1 1 - v 0 c 1 0 r t h a t c o n t a i n s a 1 1 n a b i t 

p a s i t :i. a n (0 » « 31) w h e n a ci r i v 6? i s a v a :i. 1 a b 1 0 t a r 
that bi t >t c:«r a 0 :i f thesr 0 i s n 0 dr i v 0 avai 1 ab 1 0 
tor the? bit- 

I n s t a 11 a b 1 0 ci i s k cl r i v e r s rn u s t c 0 r r 0 c 11 y m a 1 n t a i n 
t h os 1 o n q w o r d .... d r v b i t s L s os os s 5 y s 1 0 m V a r i a b 1 e? s d „ 

< 11) kbshift 

L 0 N G k 1) l"i i 11 (ni o d 0 ) 

WORD made;; 

I f m o d 0 i s n o n n 0 g a t i v 0 „ s & t s t h os k 0 y b a a r d 

s i *i i 1 1 b i t s a c: c: a r d 1 n q 1 y a n d r os t u r n s t h os a 1 ci s h i. f t 
b i t s» I f m a d e i s 1 0 s s t h a n z e r 0 n r 0 1 u r n s t h cs 
IB li •• P C c os m p a t i is 1 os s t a t os cs f t h os 0 h i 11 k e y s o n t li os 
k 0 y h o a r d ^ a s a b i t - v os c: t cs r i n t h e 1 os w b y 1 0 o t D 0.. 

B i. t a s s i g n rn 0 n t s a r 0 2 

0 R i q h t s h i f t k 0 y 

1 L. 0 11 s h i f t k os y 

2 Control key 

3 ALT key 

4 Caps.1ock 


A t a r i C o r}:?« C <s n t i ci e n t i a 1 
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5 R x q h t m o u s e b u 11 o n (C LR / i-i O ti E 

6 Left mouse button (INSERT) 

7 (r e s a r v e d , c u r r e n 11 y z e r o) 


A t a r i C o r pC o n f i c:i e n t i a i 
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E x* t e n d e d B10 S F u n c: t i o n s 


T h e s e t u n c 11 o n s a r e a v a i 1 a b 1 e t h r o u g h t r a p i 4„ T h e c a 1 1 x n q 
c: on vent i ons are the same as tor trap 1 -3 „ Contrary to the 
O E H D 0 8 s p e c i f i c a t i o n, t h e c a I i e r d o e s N 0 T h a v e t o b e x n 
s u p e r v i s o r m o d e „ 11 i s t h e c a 11 e r s r e s p o n s i b :i. 1 i t y t o 

c 1 e a n u p a r g u. m e n t s p a s is e d t o t h e t r a p (a s p e r t h e C c a 11 i n g 
standard)« 


A t y p i c a 1 t r a p h a n d 1 e r , o n e t h ax t w o r k s f r o rn a C b i n d i n g 
might bes 


trap .1.41! 

move „ 1 


t r ap 
move,, 1 


r t s 


(sp ) •+• H tr .1.4ret 
# 14 

tr 14ret „.(sp) 


r, pop ret ad dr 
s do BIOS func 
$ return to 
u H caller 


bss 

tr14rets ds„ I 


s a v e cl r e t.„ a a d r 


a n id :l t m :i. g h t b e u. s e d 1 i k e s 


* •(: u p x d w a y t o s e t t. h e s c r e e n t o ax s i n g I e v a i. u e,, 
/ 

s e t s c r e e n.t o f , v 

WORD v; 

L 

e x t. e r n 1 c::« n g t r a p .14 (; ; 
r e g i s i: e r W 0 R D * p; 
register int. i u 

«h. c r b a s e « (W 0 R D *) t r a p i 4 C 3) r, 

tor (i = Ox4000$ x 5 .i) 

*p++ = v; 


/ # 

•t X o r p a I e 11 e s x n a r a n g e w x t h a g i v e n v a 1 u e 
* / 

s e t. p a i e 11 e r a n q e x s t a r t. ^ t x n h v ) 

W 0 R D s t a r t., 11 n 9 v 5 
L 

wh x 1 e (s t ar t. < = t x n > 

t r ap 14 < 7 ,, t r ap 14 (7 , - 1 ) • * v > 5 


A t a r x C o r p ,, C o n t x d e n t x a 1 
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0.' i ni tiTious 

V 01D i n :i. t rn □ u s * t y p ep a r a rn „ v e c; 

WORD type; 

L 0 N 8 p a r a rn H v e e:::{ 

I n i t i a 1 i z e rn o u s e p a c: k e t h a n d 1 e r t y p e i s o n e 

of 2 


type Action 


0 

1 

4 


d i s a h 1 e m o u s e 

e n a b 1 e m o u s e „ i n r e I a t i v e rn o d e 
e n a b 1 e m a u s e , i n a b s o 1 u t e m o d e 
(unused) 

e n a b 1 e rn o u s e , i n k e y c o d e rn o d e 


p a r a m p o i n t s t o a p a r a m e t e r b i o c k t h a t s h a u l d 
1ook 1ikes 


s t r u c: t p a r a rn i 

8 V I E t o p rn o d e;; 
B Y T E b u 11 o n s r, 
BYTE xparam ; 
BYTE yparam; 

|» 


t o p m o d e s h o u 1 d b e 2 


Y.position 

Yposition 


0 at bottom 
0 at top 


b u tt o n s :i s a p a r a rn e t e r t or t h e k e y b o a r d s “se t 
m o u s e b u 11 o n 11 c: o rn m a n d „ 

x p a r a m a n d y p a r a rn a r e t h e X a n d Y t hr es h o I d , 
sc a 1 e or d e 11 a t ac t or s H d ep en d i n g on t h e rnod e 11"! e 
n i a u s e i s h e i n g p 1 a c e d :i n „ 


A t a r i C o r p » C o n t i d e n t i a 1 
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1l 


F o r m o u. s e a b s o I u. t e m o ci e , s o m e e x t r a g a r a rn e t e r s 
i iTirned i at e 1 y t o 11 ow t he par ameter b 1 oc k : 

s t r u c t e x t r a l 
WORD x max r, 

WORD ymax ;; 

WORD xiriitiaI; 

WORD yinitiai$ 


x rn a x a n c:l y rn a x s p e c i t y t h e rn a x i m u m X a n d 


m o u s e p o s i t i o n s. x i n i t i a I a n d y i n i t i. a i 

s p e c: i t y t lx e i n i t i a 1 X a n cl Y m o u s e p o s :i t i o n „ 


Y 


v e c p o i n t s t o a rn o u s e i n t e r r u p t h a n cl 1 e r; s e e 
e x 1: e n d e ci t u. ri c t i o n n u rn b 0 r 3 4 H k b c:l v b a s e „ t o r 

+ u r t h e r i n t o r m a t i o n a b o u t x k b ci s u. b s y s t e m 

ban ell er s . 


(1 ) ssbrk 

L i J N 8 s s b r k (a m o u n t > 

WORD amount; 

R e s e r v e a m o u n t b y t e s t r o m t h e t o p o t rn e rn c:> r y.. 

R e t u r n ii». a 1 o n q p o i n t x n g t o t h e h a s e o t t h e a 11 o 

c a t e c:l rn e rn o r y» i" hi i s t u n c: t i o n ii U S T b e c a 11 e d 

b e t o r e t h e 0 S :l us i n i t i a 1 i z e d « 

s 3 b r k i s a c t u a 11 y p r e 11 y u s e 1 e s s« 11 D 0 E S N 0 T 

V4 o r k a f t e r 8 Ei. M D 0 8 lx a s b e e n b r o t.i g h t u p , s i n c 0 t ri 0 

IRA has already been set up. 

(2 > .p h y s B a s 0 

L 0 N (3 .p hi y s B a s e () 

6 e t t h 0 s c r e e n s p h y s i c: a 1 b a s 0 a ci d r e s s (a t t h 0 

h e c^ i n ri i n g o f t lx 0 n e x t v b 1 a n k) . 

(3) .1ogBase 

L 0 N 0 .1 o g B a s 0 \ ) 

6 e t t h 0 3 c: r e 0 n s 1 o q i c a 1 b a s 0 , r i q h t a w a y „ T h i 3 
is the location that GSX uses when drawing to the 
screen,, 

i 4) getIRez 

WORD .getRez() 

6 e t t h e 3 c r 0 e n c u r r 0 r*i t r 0 s o 1 u t i o n (r 0 1 u r n i ri q 0 H 

1 or 2)« 


(o ) 


setScreen 

V 01 D s e t S c r 0 0 ri (1 o g i.... o c , p h y s L a c , r e z ) 

L.. 0 i i 8 1 o g L... o c: 9 jd h y s L o c: ? 

WORD rez 11 

8 0 1 t h 0 1 o g x c a 1 s c r 0 0 ri 1 o c: a t x o n 


<1ogLoc } 


11*10 


A t a r i C o r p « C o n t x d e n t x a 1 
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p h y s i c a 1 s c r e e n I o c a t i o n (p h y s L o c) „ a n d t h e p h y - 
s i c a 1 s c r e e n r e s o 1 u 1 1 o n« N e g a 1 1 v e p a r a m e t e r s a r e 
x g n o r e d ( rn a k i n g i t p o s s i h j. e n f o r i n s t a n c e ,, t o s e t 
s c r e e n r e s o l u t x o n w i t h a u t c h a n q i n g a n y t h x n q 
e j. se ) ,, 

T h e J. o g x c a 1 s c r e e ri 1 o c a t i o n c h a n g e s i rn rn e d i a t e 1 y » 
1' h e p h y s i c a I s c r e e n I o c a t x o n h a r d w a r e r e g 3. s t e r x s 
e h ax n g e d x rn rn e d i a t e i y , h u t t h e n e w s c r e e n 1 o c a t i o n 



wi I 

1 

take effect 

after 

the next 

vertica 

1 

r 

etr a 

ce., 


Whe 

n 

resoluti on 

x s c 

hanged 

t h e s 

c 

re 

en 

x s 


c 1 e 

ar 

ed, the curs 

or i s 

homed, an 

d the V 

T 


ter 

m i — 


n a .1. 

e rn li I a 1 0 r s t a t 

0 i s r 

eset „ 






__setP 

a 11 e 

te 









VOID 

_set 

Pa 

11 ete(palett 

ePtr) 







LONG 

pal e 

tt 

ePtr .1 









Set 

t 

he contents 

of the 

hardware 

pal ett 

e 

r 

eg i s 

ter 


(a 1 

1 

16 color en 

trxes) 

from the 

16 wor 

d 

s 

poi n 

ted 


1 0 

by 

palettePtr 

P 

a 1 e 11 ep t r 

MUST 


be 

on 

a 


wor 

d 

boundary,, 

The 

p -a ]. ette 

as si gn merit 

ta 

kes 


p 1 a 

ce 

at the begx 

nni ng 

of the ne 

xt vert 

i 

ca 

1 bl 

an k 


int 

er 

rupt« 








.setC 

oi or 










WORD 

.setCo 

I or(col orMum 

n col or> 







W 0 R D c o i o r N u rn „ c o 1 o r 5 

S e t t h e p a 1 e 11 e n u rn b e r c o .1. o r N u rn i n t h e h a r d w a r e 
p a 1 e11 e t ab I e to the q x ven c:o 1 or « Ret ur n t he o I d 
c o 1 o r x n 0 0« W« I f c: o 1 o r i s n e g a t i v e, t h e 
h a r d w a r e r e g i. s t e r i s n o t c h a n g e d« 

(8) f1oprd 

WORD .f1 oprd (but , f x 11 er , devno, sect.no, trac: kno n 

s x d e n o «, c:: o u n t) 

LONG but , f x 1 I er 11 

W 0 R D d e v n o , s e c t n o „ t r a c k n o , s i d e n o, c: o u n t r, 

R e a d o n e ar rn o r e s e c t o r s t r c:« m a f 1 o p p y d x s k » 
•f i 11 e r x s a n u n u s e d 1 o n g w o r d» b u t rn u s t p o x n t 

t a a w o r d.a I x g n e d b u f f e r 1 a r g e e n o u g h t o c o n tax r "! 

t h e n u rn b e r o f : s e c t o r* s r e q u e s t e d« d e v n cj ' x s t h e 
f i o p p y n u. m b e r < 0 o r 1) « s e c t n o i s t h e s e c 10 r 
n u m b e r t a s t a r t r e a d x n g t r cj m (u s u a 11 y i. t hi r o u g h 
9) » t r a c k i '? c::* x s t h e t r a c k n u m b e r t o s e e k t o „ 
s i d e n o i s t h e s x d e n u m b e r t o s e 1 e c t« c: o u n t ' 
x s the number of sec: tor s to read (wh x ch must be 
less than or equal to the number of sectors per 
track)„ 

0 n r e t u r n , 5 D 0 c o n t a i n s a s t a t u s c r.::» d e» J! f D 0 x s 
z e r o cj t h e o p e r a t i o n s u c: c e e d e d « I f D O i s n c:* n z e r c j ,, 
t h e o p e r a t x o n f ; a x I e d < a n d D O c a n t a x n s a n e r r o r 

Atari Corp» 


Centx dent x ai 
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number) 


( 9 ) tiopwr 

W 0 R D 11 o p w r (b u t , f i 11 e r n d e v n o „ s e c t n o , t r a c k n o , 

is i d e n o «, c o u n t) 

LONG but H t i 11 er ;; 

W 0 R D d e v n o „ s e c t n o ,, t r a c k n o,, s x d e n o h c d u n t 

W r :i. t e o n e o r m o r e s e c t o r s t o a f 1 o p p y d i s k 
b u f rn u s t p o l n t t o a w o r d - a I i g n e d b u t f e r „ 
tiller is an unused longword- devno is the 
t I o p p y n u rn b e r (0 o r I > » s e c t n o i s t h e s e c t o r 
number to start writing to (usually i through 9)„ 
t r a c I**: n □ i s t h e t r a c k n u m b e r t o s e? e k t o „ 
s i d e n o i s t h e s i d e n u m b e r t o s e i e c t« c o u n t 
i s t h e n u m b e r o t s e c t o r s t o w r 1 1 e < w h i c h rn u. s t b e 
less than or equal to the number of sectors per 
track>„ 

0 n r e t u r n D 0 c o n t a i n s a s t a t u s c o d e „ I f D 0 i s 
z e r o * t h e o p e r a 1 1 o n s u c c e e d e d« I f D 0 i s n o n z e r o,, 
t h e o p e r a t i o n f a i I e d < a n d D 0 c o n t a i n s a n e r r o r 
number)„ 


W r i t i n g t o t hi e t) o o t sec t o r (s e c t o r I ,, s i d e 0 , 
tr ack 0) wi 11 cause the med i a to en fcer the “ m i gh t 
h a v e c h a n g e d “ s t a t e „ I h i s w i 11 b e r e f I e c t e d o n 
t hi e n e x t r w a b s () o r m e d i a c: h () B10 S c a 11 . 

<10) .f1 optmt 

W 0 R D .f 1 o p f m t (b u f , f i 11 e r „ d e v n o „ s p t , t r a c k n o „ s i d e* n o ,, 

i n t e r 1 v , m a g i c , v i r g i n) 

LONG but H fi11er $ 

W 0R D ci e v n o s p t H t r a c k n o „ s i d e n o, i n t e r 1 v h v i r g i n ; 

LONG magi c r, 

F co r rn a t a t r a c:: k o n a i : 1 o p p y d i. s k « b u f rn u s t 

p o i r"s t t o a w o r d - a 1 i q n e d b u f f e r 1 a r g e e n o u g h t o 
h d 1 d a n e r"j t i r e t r a c k i m a g e (8 K f o r 9 s e c: t cj r rs ~ 

p e r.t r a c k > « f i 11 e r i s a n u n u s e d 1 o n g w o r d« 

d e v n a i s t h e 1 1 o p p y d r i v e n li rn b e r (0 o r I .t» 

s p« t i s t h e n u m b e r o f s e c: t a r rn-—p e r — t r a c k t a f o r — 
m a t (u rs u a . 1 . 1 y 9) « t r a c k n o i s t h e t r a c k n u rn b e r 
t o f c:« r rn a t (u s u a 11 y 0 t o 7 9 ) « s i d e n o i s t h e 

side number to format (0 or I). inter!v is the 

s e c t o r **•“ :i. n t e r 1 e a v e f a c t c:« r (u s u a 11 y 1) » m a g x c: i s 

a rn a q ;i. c n u rn b e r t r "! a t M U S T b e t h e v a 1 u e 8 76 54321» 

’ v i r g i n i s a w o r d f i 11 v a 1 u e f a r n e w s e c t o r s« 

0 n r e t u r n ,, D 0 c cs n t a i n s a s t a t u s c o c:l e» I f 0 0 i s 
z e r c« „ t h e o p e r a t i o n s u c: e e e d e d . I f I) 0 i s n o n z e r o ,, 
t i“i e o p e r a t i o ri f a i I e d < a n d D 0 c o n tains a n e r r o r 
n u m b e r ) „ T h e f o r m a t f u n c t i. o n c a n s o f t — fail w r ■{ e n 

i t f i ri d s b a d s e c t o r s d u r i n q t h e v e r i f y p a s s „ T h e 

c a 11 e r h a s t h e c h o i c e o f a 11 e m p t i n g t o r e—f o r m a t 


A t a r i C cj r p «. C o n f i d e n t i a 1 
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i 4 


t. h e m e d i a , o r r e c o r d x n g t h e b a d s e c t o r s s o t h e y 
w i 11 n o t b 0 i n c 1 u d e d i n t h e f x I e s y s 1 0 m« 

A n u I X --1 e r m i n a i 0 d i 0 « W) X x s t o t b a d s e c: t o r 
n u m b e r s i 0 r e t u r n 0 d x n t h e h u f 1 0 r. T h 0 y a r 0 n o t 
n 0 c 0 s s a r x X y i n n u m 0 r x c a X o r d 0 r * < X f t h 0 r 0 w e r 0 

n o b a d s 0 c 1 0 r s n t h 0 f ; i r s t w 0 r d i n t h 0 b u 11 0 r w x X 1 
be zero.> 

A g o 0 d v a X u 0 f 0 r v i r q i n i s # EX 5 EX 5 .. T h 0 h 1 q h 

nibbX 0 0f 0ach by 1 0 x n th0 virgin param0 1 0r 

m u. s t n 0 1 b 0 0 q u a X 1 0 $ F .. R e 0 x s t t h 0 1 0 m p t a t i 0 n 

1 0 f o r m a t a d i s k w i t h s 0 c 1 0 r s x r? i t x a X i z 0 d t o 
z er 0 „ 

F 0 r rn a 11 1 n q a t r a c: k w x X X c a u s 0 t h 0 m 0 d x a 1 0 0 n 1 0 r 
the "de f xnitely changed" state» i nis wiXX be 

r 0 f X 0 c 1 0 d 0 n t h 0 r"s 0 x t r w a b s <) 0 r rn 0 d i a c h () B X 0 8 

c a X X „ 

i J. ) u. s 0 d -• b y B X' 0 S 

V 0 X D u. s 0 d - b y -• B 10 S <) 

i 0 b s 0 X 0 1 0 t u nt x 01 “i 1 

( 12 ) midxws 

VO I D rn i d i iais (c n t,, p t r ) 

WORD cnt; 

LONG ptr i; 

W r x 1 0 s a s t r x n q 1 0 t h e ii X D X {::> o r t. c n t i s t h e 

n u m b 0 r c .3 f c: h a\ r a c: 1 0 r s t o w r x t e 9 m x n u s 0 n 0» p t r 

p 0 x n t s 1 0 a v 0 c 1 0 r 0 *f ; c h a r a c 1 0 r s 1 0 w r :i. 1 0 „ 


( 13 )..rnt px nt 

V 0 X D .m f p x r i t ( i n 1 0 r n 0 v 0 c: 1 0 r) 

W 0 R D x n 1 0 r n o 5 
LONG vectorn 

S 0 1 t h 0 ii F r P :i. n i: 0 r r u p t n u m b e r i n 1 0 r n □ ' (0 1 0 X 5 ) 

t o ' v 0 c 1 0 r « T h e o 1 d v e e t o r i s vm r i. 11 0 n o v 0 r (a n d 
t h u s u n r 0 c 0 v r a b X 0 > « 


(14) xorec 

I.... 0 N 8 i q r 0 c (d 0 v n 0 ) 

WORD devil or, 

R 0 1 u r n s a p 0 i n 1 0 r 1 0 a 0 0 r i a X d 0 v x c 0 s x n p li t 
b u 11 0 r r 0 c o r d« d e v n 0 x s o n 0 o f u 

devno Devi c:e 

0 RS232 

1 Keyboard 

2 ii X D X 


A t a r 1 C o r p « C o n f i d e r "i t x ax X 
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IS 


The stru.cture ot the record iss 
struct iorec 


LONG 

i but n 

/ * 

pointer to 

butf er 

WORD 

ibutsiz^ 

/ * 

s 1 z e a f b u f f e r * / 

WORD 

ibuthd; 

/ * 

head index 


WORD 

ibut ti 5 

/ * 

tail index 

#/ 

WORD 

ibut 1ow; 

/ *!• 

1 ow-water 

mark */ 

WORD 

i bu.t hi ; 

/ 

hi gh“-water 

mark */ 


F o r R S 232 , a n o u t p u t ~ b u f f e r r e c o r d i rn m e d i a t e I y 
tollows the input-buffer record. The format of 
t h e o u t p u t - b u f f e r r e c o r d :i. s i d e n t i c a i „ 

i bu.f po:L nts to the devices buf f er» lbuf si 2 

i s 1 h e b u f f e r s s i z e« i b u f h i i s t h e b li f f e r s 

h i g h.w a t e r m a r k „ i b u f 1 o w " is t h e b u f f e r s 1 o w - 

water mark„ 

I f f i c:» w c: o n t r o 1 i s e n a b . 1 . e d a n d t h e n u rn b e r o f 
c hi a r a c t e r ss i n t h e b u t f e r r e a c h e s t h e hi i g h ~ w a t e r 
m a r k , t h e 6 T r e q u. e s t s (a c c o r d i n q t o t h e f 1 o w - 
c o n t r o 1 p r o t o c o 1 ) t h e s e n d e r t o s t o p s e n d 1 n g 
c h a r a c t er s« Wh en t h e n u m b e r o f c h a r a c: t er s i n t h e 
b u f f e r d r ops b e i o w t h e 1 o w - w a t e r rn a r k , t h e S T 
tel is the sender to resume transmission. 


7 h e f J. o w ~ c: o n t r o 1 o p e r a 1 1 a n 1 s s i m i 1 a r f o r t h e 
R 8 .232 o u t p u t r e c o r d » 

(15) rscont 

V 01D r s c o n f (s p e e d n f i o w c 11 n u c: r H r s r , t s r , s c r ; 

WORD speed, fI owe 11 , ucr, rsr, tsr, scr; 

C o n f i g u r e R S -232 p o r t« I f a n y p a r a rn e t e r i s — 1 
< 4 : F F F F .? , t h e c c:« r r~ e s p o n d x n g h a r d w a r e r e g i s t e r i s 
n o t s e t» s p &! e d s e t s t h e p o r t ' s b a u d rate, a s 
per n 


speed 


Rate (bps) 


0 

:i 

4 


19H 200 
9600 


4800 

3600 

2400 


2000 


6 1800 

7 1200 


8 600 

9 300 


A t a r i C o r p .. C o n f i d e n t i a 1 
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10 

200 

11 

150 

12 

134 

13 

110 

14 

75 

15 

50 


f 1 o w s e t s t h e 11 o w c o n t r o i « a s p e r;; 
tIow FIavor 

N o t I o w c:: o n t r o 1 i p o w e r u p d e f a u 3. t 3 
X ON / XOFF (* *8 / • "*Q) 

E 7 S / C T S 

X 0 N / X 0 F F a n d R T S / C T S L i s t h i s u s © f u I ? II 



ucr „ rsr tsr 9 and scr set the appropri- 
at e 6890 i r eg i st er s.. 


<16) keytbl 

L 0 N G k © y t b 1 < ix n s h i f 1 9 s h i f t, c a p s 1 o c k ) 

L 0 N G u n s h :i. f 1 9 s h i f t „ c: a p s 1 o c: k ; 

8 e t s p o i n t © r s t o t h e k e y b o a r d t r a n s 1 a 11 o n 
t o r u n s h i f t e d k e y s», s h i 11 e d k e y s, a n d 
c a p s 1 o c k m o d © „ R © t u r n © a p o i n t e r t o t h © 
n i n g c:* f a s t r u c t u r e s 


tahles 
keys in 
toegi n~ 


s t r u c t k e y t a b 1 


LONG 

unsh :i. ft 9 

/ *. 

> u n s h i 11 t a h 1 © 

LONG 

shift ^ 

/ * - 

> s h i f t t a b 1 e * / 

LONG 

capsl qc k i; 

/ * — 

> c a p © 1 q c k t a b 1 e 


*/ 


E a c h p o i n t e r i n t h © s t r u c t u r © s I" ! o u 1 d p o i n t t o ax 
t a b 1 © 12 8 h y t e s i n 1 e n g t h * A s c: a n c o d e :t s c: a n -- 

v © r t: E? c:l t o A s c i i b y :i. n d e x i n g i n t o t h e t a b 1 © a n d 

t a S-:; :i. n g t h © b y t © t h e r © „ 


C17) _random 

L.. 0 H 8 .r a n d o m < > 

R © t u r n s a 2 4—h i t p © u © d o -• r a n d o ai ri u. m b © r i n D 0» i...» 

B i. t is 2 4« ,, 3* 1 w :i. 11 b e z © r o» T h e © e q u e n c © / s h o u 1 d / 

b © d i f f © r © n t © c h t i m e t h © s y s t m i s t u. r n e d o n „ 

L T h e a 1 g o r i t h m i aa t r o rn v o 1 M 2 o t K n u. t h s 

iB -™ [! 8 # C ] ■+• K 

w h © r * © K = 1 ,, C = 3141592621 „ a n d S is t h e s © © d » 
S >> 8 is returned. The initial value o-f S is 

taken trorn t h e fram©—caunter ' frclock ,, II 


At ari Corp » Confidentia1 
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T h e f u n c t i o n s b e h a v i o r i s s u r p r i s i n g 1 y g o o d 
0 x c 0 p t t h a t b i t 0 h a si- a n / e x a c t / d i s t r i b u t i a n o t 
50%» Therefore it is probably not a good idea to 
t e st i n d i v i d u. a i b i t s an d ex p ec t t h ern t o b e we 11 
behaved« 


( 18 ) .protobt 

V 01D _ p r o t o b t (b u f n s e r i a 1 n o, d i s k t y p e 9 e x e c 11 a g > 

L 0 N 0 h u f n s e r 1 a 1 n o; 

W 0 R D d i s k t y p e, e x e c 11 a g $ 

l :;;i r o t o t y p e a n i rn a g e o t a b a o t sec t o r « G n c: e t hi e 
b o o t s e c: t a r :i. rn a g e h a s b e e n c o n s t r u c t e d w i t h t h i s 
f u n c t x o n , w r i t exit o t h e v o 1 u m e s b o o 1 s e c t o r « 

b u t p oin t s to a 512-byte b uf t er i whx ch may c on — 
t a i n g a r b a g e, o r a i r e a d y o o n t a x n a b o o t sec t o r 
x mage)■ 


s e r :i. a 1 n o i s a s e r x a 1 n li m b e r t o s t a m p i n t o t h e 
b o o t s e c t o r „ I t s 0 r i a X n o x s -1 , t h e h o o t 

s e c t o r s s e r x a i n u m b e r x s n o t c h a n q e d » 1 + s e r i. 

a I n o x s g r e a t e r t h a n o r e q u a i t o $01000000 „ a 
r a rs d o m s e r x a 1 n li m b e r x s g e n e r a t e d a n d p I a e e d x n 
t h e b o o t s e c: t o r 


d x s k t y p e x s e x t h e r ••••• 1 < t o 1 e a v e t h e d i s k t y p e 

x n t o r rn a t x o n a I o n e) o r o n e o f t h e t o I X o w x n q s 


0 s 
Is 


40 tracks n 
40 tracks H 
80 tracks 
80 tracks, 


si ng I. e si ded 
douix 1 e si ded 
single sided 
do Lib 3. 0 si ded 


( 180K ) 
< 360K> 
(360K) 
( 72OK ) 


11 e x e c t 1 a g i s 1 , t h e b o o t s e c t o r i s rn a d e e x e? - 
cat ab X e„ 11 ex ecfX ag is 0, the b oot sect or is 

m a d e rn o n - e x e c u t a h X e» I f e x e c t i a g i s ••••• 1 ,, t h e 
boot sector remax ns executabl e or non-executabl e? 
d 0 p e n d i n g o n t h e w a y :i. t w a s o r x q i n a 3. X y 


(19) .tX opver 

W 0 R D .t X o p v e r (b u i fill e r H d e v n o „ s e c t n o t r a c h: r n o „ 

s i d e n o * c: o u n t) 

LONG b at , t f i X X er 5 

W 0 R D c:l e v rn o n s se c t n o,, t r a c k n o n s x d e rn o „ c o u n t ^ 

V e r i t y < b y s i m p X y r e a d 1 rn g ) o n e o r rn o r e s e c t o r s 

f r o m a 13. o p p y d i s k u b u f ; rn u s t p o x n t t o a w o r d — 

a X x g n e ci X 024~~ h y t e b u f f : e r « f i X X e r x s a n t.i rn u, s e d 

1 o n g w o r d « d e v n o i s t h e f X o p p y rn u rn b e r ( 0 o r 1 ) » 

e c t rn o 3 . s t h e s e c t o r n u m b e t o s t a r t r e a d :L n g 

f r o rn (u s li a X X y X t i n r o u g h 9) » t r a c k n o i s t h e 

t r a c 1=: n u m b 0 r t o s e 0 k t o „ s i d & n o i s t h e s i ci e 

n u m b e r t o s e i 0 c t« c: o u. n t " i s t hi e n li rn b e r o f 


A t a r i C o r p« C o n t i d e n t i a 1 
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s e c t o !•“ s t o v e r 1 t y ( w h i c h rn u s t b e i e s s t h a n o r 
equal to the number of sectors per track)„ 

0 n r e t u r n , D 0 c o n t a i n s a s t a t u s c o d e« I f D 0 i s 
zero, the operation succeeded. It DO is nonzero, 
t h e o p e r a t :i. o n t a i I ed (ax n d D 0 c: o n t a i n s a n e r r o r 
number)„ 

A n u . 1 . 1 .t e r nx i n a t e d < 0 W) i i s t o t b -a d s e c t o r 

n u. nx b e r s i s r e t u r n e c:l i n t h e b u 11 e r „ T h e y a r e n o t 
n e c: e s s ax r 11 y i n n u rn e r i c a I o r d e r * < I t t her e w e r e 

n o b ax d s e c t o r s , t h e firs t w o r d i rx t h e b u t f e r w i 11 
be zero.) 

( 20 ) scrdmp 
VOID scrdmp() 

Dump screen to pr i nter « IICurrent 1 y th i s i s the 

rn o n o c h r o m e - a n I y v e r s i o n fro m C E S „ W i 11 b e fi x e d 

soon« II 

(21) curscant 

W 0 R D c u r s c o n t (t u n c t i o rx, o p e r ax rx d ) 

W 0 R D t u n c t :i. o rx, o p e r a n d 5 

Clorx t i q ur e t he ]i g i ass t er rni n a I 31 cur sor The 

t u n c t i o n c: o d e i s o n 0 o t t h e t a 11 o w 1 n g s 

0 Hide cursor 

1 Show cursor 

2 C u r s o r s e t t o h 11 n k 

3 C u r s o r s e t n o t t o b 11 n k 

4 S e t c u r s o r b I 1 rx k t i m 0 r t o o p e r a n d 

5 R e t u r n c u r s o r b 1 i n k 1 1 nx e r v ax I u e 


T h 0 c: u r s o r b I i rx k r ax t e i s b ax s e d o rx the v i d e o s c a n 
r a t e (6 0 h z t o r c: o 1 o r , 7 0 h z t o r m o n o c h r o m e , 5 0 hi z 
t or PAi... > « T h 0 rate p arameter i s 0 qua 1 to orxe- 
h a 11 t h e c y c i e 1 1 m e 

(22) settime 

V 01D s 0 11 i rn e (d a t e t i m e ) 

L 0 N G «:i ax t e 1 1 rn e ; 

S 0 1 s t h 0 i n t e 1 i i g 0 rx t k e y b o ax r cl ' s i cl 0 a o f t h e t i nx e 
and date. datetime is ax 32-bit DOS-tornxat date 
and t i nx 0 (t i rn 0 i n 1 he 1 ow word, date i rx th 0 fx i gh 
word). 

(23) get1 1 me 

L 0 N G g e 11 i m e () 

I n 1 0 r r o g ax t e s t h e 1 n t e 11 i q e r x t k e y b o ax r d s i d e a o t 

t h 0 1 1 m 0 a n d d a t e , a n d r e t u r rx s t h a t v a I u e ( i rx DOS 

format) as at 32—bit word.. (Time in the low word, 

d a t e i n t hi e h i g h w o r d > « 

A t a r i C o r p „ C o rx t i d e rx t i a 1 
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(24) bioskeys 

V 01D b i o s k e y s () 

E e s t o r 0 s t h e p o w 0 r u p s e 11 i n g s o t t h 0 k y b o a r d 
t r a n s 1 a t i o n t a b 1 0 s« 

(25) ikbdws 

V 010 i k b d w s ( c n t „ p t r ) 

WORD cnt ? 

LONG ptr? 

W r i t e s a s t r i n g t o t h 0 i n 1 0 i 1 1 q 0 n t k 0 y b o a r d „ 
c n t :i. s t h 0 n u m b 0 r o t c h a r a c 1 0 r s t o w r i t e , m i n u s 
o n 0 p t r p o 1 n t s t o a v 0 c t o r o t c h a r a c t & r s t o 
wr 1 te„ 

(26) jdxsint 

VOID jdis1n t(in t n o) 

WORD int.no; 

01 s a b i 0 i n 1 0 r r la p t n u m L e* r i n t n o o n t h e* 68901» 


(27) jenahxnt 

V 0 J.' D j 0 n a h i n t *; i n t n o) 

WORD intno; 

E n a b j. 0 i n t e? r r li p t n u m b 0 r i n t n o r o n t h 0 6890 i „ 


(28) giaccess 

& Y T E g i a c c 0 s s (d a t a , r 0 q n o) 

BYTE data; 

WORD regno? 

R 0 a d o r w r i 1 0 a r 0 g i s 1 0 r o n t k 0 s o u n d c h i p * 
r 0 g n c::* i s t h 0 r 0 g i s 1 0 r n u m b 0 r , 1 o g i c: a 11 y 0 R e d 
wi t h s 

:£ O O t o r 0 a d L w ell h o I c , y o u d o n t 
/ r 0 a 11 y / 0 R w i t h t h i s« « « 2 
$80 to write 

d a t a i s a b y 1 0 t o w r i 1 0 t o t h e r 0 q i s t e? r „ 

S o u n d c h i p r 0 g i s 1 0 r s a r 0 n o t s h a (i o w e d „ F 4 r q -- 

c 0 dur 0 s t hat c:harig 0 r &g x s1 0 r va 1 u 0 s by r E^ad 1 ng a 
r 4 0 g :i. s 1 0 r ,, mod i t y x n g a 1 o c a 1 c o p y o f 11, a n d w r x t — 
i n g t h 0 r e^ s u J. t b a c k t o t h 0 r 0 g i s 1 0 r , 5 s h o la 1 d b e 
criti ca i. e?c:tx ons„ 1 n parti cu 1 ar , th 0 B10S (f r 0 - 
q u 0 n 11 y; u p d a 1 0 ss t h 0 P 0 R T A r 0 g i s 1 0 r H a n d a n y 

c: o d 0 t h a t r 0 a d — m o (d i t y w r i 1 0 s P O R T A m la s 1 b 0 

atomx c: „ 

(29) ottgibxt 

VO1D offgibit(bit no) 

WORD bitno; 

At omicaiiy set a bit in t he PORT A r egister t o 
zero,, 


At ar i Cor p ,, Conf i dent i a 1 
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(30) angxbit 

VOID ongihit(bitno) 

WORD bitno; 

A t o m i c: a 1 i y s e t a b i t i n t h e P 0 R T A r e g i s t e r t o 
on 0 * 


<31) xbtimer 

V 01D x b t i m e r (t i rn e r H c o n t r o 1 d a t a. „ v e c ) 

W 0 R D 1 1 m e r , c o n t r o I , d a t a n 

LONG V0C$ 

timer is the timer number <0, 1, 2, 3 

c: o r r e s p o n d i n g t o 68901 t i m e r s A „ B , C a n d D) „ 
c: o n t r o 1 i s t h e t i m e r s c: o n t r o 1 - r e g i s t e r s e t - 
t x ng « data x s a byte shoveci x nto the t x mer s 
d a t a r e g i s t e r » v e c i s a p o i n t e r t o a n i n t e r* - 
rupt handler« 

T i rn e r s a r e a i 1 o c a t e d ii 


T i mer 
A 
B 
C 
D 


Usage 

R e s e r v e d t o r e n d—u s e r s a n d a p p 1 i e a t i o n s 
R e s e r v e d f o r g r a p h x c s < h b 1 a n k s y n c r, e t c « 
S y s t e m t i m e r < 200h z ) 

R S -232 b a u d — r a t e c: o n t r o i < t h x s t x m e r s 
i n t e r r u p t v e c t o r is a v a i 1 a b 1 e t o a n y o n e > 


(32) dosound 

V 01D d o s o u n d (p t r ) 

LONG ptr ? 

S e t s o u n d d a e rn o n s 11 p r o g r a m c o t.i nter" t o p t r » 

’ p t r p o x n t s t o a s e t o t c o m m a n d s o r g a n 3. z e d a s 
bytes» 


C o rn m a n d n u rn b e r s # 0 0 t h r o u g h $ 0 F t a k e a o n e b y t e 
a r g u m e n t t o b e s h o v e d i n t o a s o u n d c h 3. p r e g i s t e r „ 
< C o m m a n d $ 0 0 s h o v e s t h e b y t e i n t o r e g i s t e r 0 , 
c: o m m a n d :i. s h a v e s t h e h y t e i n t o regis t e r 1 ^ a n d 
y o li g e t t h e i d e a« « « ) 

C o m rn a n d $ 8 0 t a k e s a o n e b y t e a r g u m e n t w i f i c: h i s 
ib h o v e d i n t o a t e m p o r a r y r e g i s t e r » 


C o m m a n d $ Ei :i. t a k e s t h r e e o n e - b y t e a r g u m e n t s« T h & 

t x r s t a r g u m e n t x s a r e g x s t e r n u m h e r t o 1 o a ci „ 
u s x n cj t r i t e m p r e g i s t e r „ T h e s e c o n ci a r g i„i m e n t x s 
a 2 ‘ s c: o m p l e m e ! " i t v a 1 u. e t o b e a d d e ci t o t h & t e m p 
r e g x s t e r T h e t h i r d a r g u rn e n t i s t h e t e r rn 3. n a t i o n 
v a 1 u e « 1 i’“i e 3. n s t r u c t i. o n i s e x e c ix t e d (o n c e o n e a c l"i 

u fa d a t e) li n t i i t h e t e m p r e g i s t e r e q u a i. s t h e t e r rn i - 
nati on vai lie. 


Commands :^82 through #FF take a one-byte 


A t a r i. C o r p » C ex n i 3. d e n t. i. a i. 
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argument „ It the arqu rn ent i s zero, the sound i s 
1 0 r m i n a t e d . (!) t h e r w i s e t h e a r q u m e n t r e f 1 e c t s t h e 

number of system 1xmer t x cks (at 5Ohz) un111 the 

next update- 

(33) setprt 

W 0 R D s e t p r t (c o n t i g > 

WORD contxg ; 

S e t / q e t p r i n t e r c o n t x g u r a t x o n b y t e. 1 f c o n f x g 

i s — 1 < $■ F F F F) r e t u r n t h e c u r r e n t p r i n t e r c o n t x — 

g u r a t x o n b y t e. 01 h e r w x s e s e t t h e h y t e a n d r e t u r n 

it's old value, 


B x t s c: u r r e n 11 y d e f x n e d a r e s 


Bii# When 


When 1 


0 

1 


6 


Dot ma.tr i x 
Col or device 
Atari prx liter 
Dratt mode 
Para11 el port 
Fonrr-f eed 

reserved 


Daisy wheel 
lionochr ome devx c e 
,l Epson “ pr i n ter 
Final mode 
R8232 port 
8 x ngle sheet 


7 reserved 

8 reserved 


9 reserved 

10 reserved 


11 reserved 

12 reserved 

13 reserved 

14 reserved 

15 Must be zero 


C 3 4 i k b d v b a s e 

L 0 N 6 k b d v b a s e () 

R e t u r n a p o x n ter t o t h e b a s e o t a s t r u c. t u r e s 
s t r u c t k b d v e c s i 


LONG 

midivec 5 

/ * 

MIDI-input *>/ 


LONG 

vkbderr 5 

/ * 

k e y b 0 a r d e r r 0 r * / 


LONG 

vmiderr 5 

/ 

MIDI error */ 


LONG 

statvec? 

/ -:4 

i k b d s t a t u s p a c k e t 

*/ 

LONG 

mouse vec r, 

/ * 

m 0 u s e p a c: k e t * / 


LONG 

clockvec; 

/* 

c:lac:k packet */ 


LONG 

j oy vec: r, 

/ft* 

j oy st i c k p ac: k et * / 


LONG 

midisys 5 

/ * 

s y s 10 m li ID 1 v e? c: 10 r 

•if / 

LONG 

x kbdsysr, 

/ 

s y s t e rn J! K B D v e c: 1 0 r 

*/ 


“ 5 " ?* 

rn i d i v e c: x s x n i t i a 1 i z e d t o p o x n t t o a b u f t e r i n g 

. A t a r i C o r p « C o n t x d e n t i a 1 
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r o la t i n 0 i n t h e B10 £>» D 0B w i I 1 c o n t a i n a c: h a r a c 
t e r r 0 a d f r o m t h 0 MI D I p 0 r t » 


v k b d 0 r r a n d v rn i d 0 r r a r 0 c a 1 I 0 d w h b n 0 v 0 r a n 
o v 0 r r u. n c: a n d 3. t i a n x s d 0 1 0 c 1 0 d a n t h 0 k 0 y b o a r d o r 
i v l IDI 6850 s« L P r o b a b 1 y n 0 1 a u 0 0 f la 1 v 0 c t o r 1 0 
grab-J 

‘ statvec , mou.s 0 V 0 c: H 'clockvec , and joyvec: 
p 0 i n t t o i k b d s t a t u 0 , m 0 u s e „ r 0 a 1 -1 i m e c: 1 0 c k H a n d 
j 0 ys 1 x c k p a c k 0 1 h a n d i 0 r s - T h e p a c k 0 1 h a n d 1 0 r s 
a r 0 p a s s 0 d a p 0 i n 1 0 r t0 t h 0 pa c k 0 1 r e c 0 3. v 0 d 1 n 
AO, and on the stack as a LONG., GEM/GSX lasbs the 
iTi 0 la s 0 v 0 c t0 r « H a n d 1 0 r s s h o u 1 d r 0 1 la r n w i t h a n 
R T 8 , a n d s h, 0 u 1 d n o t s p 0 n d rn 0 r e t h a n 1 m s h a n d 1 i n g 
t h 0 i n 1 0 r r la p t„ 

Th0 rni di sys and i kbdsys v0c: 1 a rs ar0 cal ied 
w h 0 n c h a r a c 1 0 r s a r 0 a v a i I a b i 0 0 n t h 0 a p p r 0 p r i a 1 0 
6 El 5 0 - I n :i. t i a i 1 y t h 0 y p 0 i n t 1 0 d b t a u I t r 0 la t i n 0 s 
< t h 0 li IDI h a n d 1 0 r 3. n d i r 0 c t s t h r 0 la g h rn 1 ci i v 0 c , 
a n d t h 0 :i. k b ci h a n ci J. 0 r p a r s 0 s 0 la t i k b d p a c k 0 1 s a n d 
c a 11 s t h 0 a p p r o p r :i. a t e s la b s y s 1 0 rn v 0 c t0 r s) - 

( 35 ) kbrate 

W 0 R D k b r a 1 0 < i n i t i a I , r 0 p 0 a t) 

WORD inxtia 1 , r epeat $ 

Get/set the keyboard s repeat rate- initia 1 

g 0 v 0 r n s t h 0 i n 3. t i a i d 0 1 a y (b 0 1 0 r 0 k 0 y — r 0 p 0 a t 
s t a r t s > r e p 0 a t g 0 v b r n s t h 0 r a 1 0 a t w h i c h 
I-:;0y—rep0ats ar0 g0n0ra 1 0d . If a param0 1 0r i s ~~:i. 
(F F F : ‘ F) 3. i:. 3. s n o t c h a n g b d« T :i m 0 s a r 0 b a s e d o n 

s y s 1 0 m 1 3. c k s (5 0 h z ) « 

R e t la r n s t h e 0 1 ci k e y—r 0 p 0 a t v a J. la 0 s , w x t h x n i t x a 1 
:i. n t h 0 I "! x g h b y 1 0 0 f t h b l a vm w 0 r d a r 0 p 0 a t 3. n 

t h 0 j. 0 w b y 1 0 0 f t hi e 1 a w w ex r d „ 

( 36 ) .prtblk 

VOID pr tblk () 

i :;: ‘ r t b 1 k (> p r i m x t x v e l s e 0 m a n u a 1 p a g e s o n P i :; < T B L K J ,, 

(37) vsync 
VOID vsync() 

W a i t u i'l t x 1 t ti 0 ri 0 x t v 0 r t x c a 1 ••••• h I a n k x n t e r r u p t a n d 
r e t la r n s« U s e t u i. t o r s y n c h r o n 3 . z 3 . n g g r a p h i c: s 

0 p 0 r a 13 . d n s w x t h v b I a n k „ 

( 3 EB) sup exec 

V 01 D s u p e x e c (c o c :l e p t r ) 

LONG codeptr; 

c 0 d 0 p t r p o x n t s t o a p x e c e o t : c o d e , e n ci x n g x n a n 
R T 8 ? t h a t x s e x e c u t e d i n s u p e r v x s o r m o ci e» T h e 


A t a r i C o r p « C o n t i d e n t i a 1 
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c od e c an n ot p car *f or m B108 or 8EMD0S c a 11 s« T h i s 
f unc t i on i s mean t t o a 11 ow pr oqr am® 1 o hac: k 
hi a r d w a r e a n d p r o t e c t e d i o c: a 1 1 o n s w x t h o u t h a v i n g 
t o fid die wit h 6EMD0S g et/set super visor mod e 
c: a 1 i . 

(39) punta.es 

V 01D p u n t a e s () 

Throws away the AES, -freeing up any memory it 

u s e d „ 1f t h e A E S i s s t i 11 r e s i d e n t, i t w x 11 h e 

discarded and the system wx 11 reboot „ 11 the AE8 

x s n o t r e s i d e n t ( x f i t w a s d i s c a r d e d e a r 1 x e r ) t h e 

•f Li n c t x o n w ill r e t u r n « 

T h e r e x s N 0 w a y t o t h r o w a w a y t h e A E 8 a n d r e t u r n 

the reboot MUST be performed, COk, ok . we 

know this is a lose. II 


At arx Corp* Con tident x a I 
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C O N 0 Li T E s c a p e S e q u e n c e s 


T h e s e a r e t h e e s c a p e t u n c t i o n s i n t e r p r e t e ci 

c o n o la t i ) i- u n c t i o n . F o r . t h e m o s t p a r t t h e y 

t e r m i n a 1 L t h a t s t h e e a s y o n e t o ci o II, T h e r e 

t o h a c k s c r e e n c o 1 o r s , c o n t r o 1 s c: r e e n w r a p , 

s i m p I e t la n c: 13. a n s» 


by the BIOS 

e m la 1 a t e a V T.5 2 

a r e e x t e n s i a n s 
and a tew other 


Cursor Up 

T h i s s e q u e n c e rn o v e s t h e c u r s o r u p o n e 1 i n e« 1t t h e 

c u. r is o r i s a 1 r e a d y o n t h e t o p 1 i n e o f t h e s c r e e n ,, t hi i s 
s e q u e n c e h a si- n o e f tec t „ 


ESC B 

Cursor Down 

T l"i i s rn o v e s t h e c: u r s o r d o w n o n e i i n e „ I f t h e c: la r s o r i s 
a 1 r e a d y o n t h e 1 a s t 1 i n e o t t hi e s c: r e e n „ t hi i s e s c a p e 
sequence has no e11 ec t„ 


ESC C 

C la r s o r i :;: ' o r w a r d 

This moves the cursor one position to the right,, It 
this function wo la Id move the cursor off the screen, 
t h i s s e q u e n c e h a s ri o e t f e c t» 


ESC D 

C u. r s o r B a c k w a r d 

F h i s m o v e t h e c u r s o r 
a n o n -• ci e s t r u c t i v e 
w h i c h t h e c u r s o r n o w 
11 t h e c la r s o r i s 


o n e p o s i. t i o n t o t h e left. I h i s i s 
m o v e b e c a u s e t h e c h a r a c: t e r o v e r 
r e s t s i is- n o t r e p 1 a c e d b y a b 1 a n k„ 
a 1 r e a d y i n c: o 1 u rn n 0, t h i s e s c a p e 


s e c| la e n c e h a s n o e t f e c: t,, 


ESC E. 

C1 e a r S c: r e e n < a n d hi o rn e C u r s o r ) 

This moves the cursor to column 0, row I (the top 

I e f t h a n d c o r n e r o *f t h e s c r e e n ) , a n ci c 1 e ax r s a 11 c h a r a c . 

t e r s f : r o m t h e s c: r e e n* 


ESC H 

Home Cursor 

T h i s rn o v e t hi e c: la r s o r t o c o 1 u m n 0 , r o w 0 » T h e s c: r e e n i s 

NOT cl eared„ 


ESC I 

R e v e r s e I n d e x 

l y l o v e s t h C ! c u r s o r t o t h e s ax m e h ca r i z o n t a i p o s i t i cj n o n t h e 


Atar1 Corp 


Con-f x dent x a I 
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p r e c 0 d i n g i i n e s.. I f t h e c u r s o r iso n t h e t o p 1 i n e? ,» a 
s c r o 11 d o w n i s p e r f o r m e d,, 

ESC J 

Erase to End of Page 

E r a s e s a i 1 t h e i n f o r m a t i o n f r o m e: u r s 0 r (i n c .1. u d i n g c: u r — 

s o r p o s i t i o n) t o t h e e n d o f t h e p a g e. 

ESC K 

C1 0 a r t o E n d o f L i n 0 

f h i s s 0 q la e n c: 0 c 1 0 a r s t h e I i n e t r o m t h 0 c u r r 0 n t c: la r s o r 

p o s i 1 1 a n t o t h 0 0 n d o t t h 0 1 x n e» 

ESC L 

Insert Line 

I n s 0 r t s a n e w h 1 a n k I x n e b y rn o v i n g t h 0 1 x n 0 t h a t c u r s o r 
:i. s o n „ 0 n d a 11 f o 1 i o w i n g 1 i n 0 s , d o w n o n 0 1 x n 0« ! h 0 n , £ 

t h 0 c u r s o r x s rn o v 0 d t o t h 0 b 0 g i n n i n g o f t h 0 n 0 w b I a n k 
i 1 n e« 

ESC H 

Del 010 Line 

D 01 e 10 t h 0 «::: o n 10 n t s o f t h 0 I x n 0 t h a t t h & c u r s 0 r i s 0 n 

p X a c 0 s t h 0 c la r s o r a t t h 0 b 0 g 1 n n x n g o f t h e 1 i n 0 , m o v 0 s 

a 11 t h 0 f 011 0 w x n g I x n 0 s u p 0 n 0 1 i n 0 H a n rj a d d s a b J. a n k 

I i n 0 a t t h 0 b 011 o rn. 

ESC Y 

l ;:: - 0 s x t x o n C u. r• s 0 r 

f I"! 0 t w 0 c: h a r a c t e r ni> t h a t f 0 1 1 o w t h e 11 Y * 5 s p 0 c x t y t h e r 0 w 
a n d c cd I u rn ri 10 w h x c: h t h 0 c: u r s o r i. s t o b 0 m o v 0 d . T h 0 
t x r s t c h a r a c 1 0 r s p e c: x f x & s t h 0 r 0 w n t h & s e c. o n d s p 0 c: i f x 0 s 
the colum. Rows and columns number from 1 up. 

ESC b 

S 01 F o r 0 g r o u n d C o 1 c.d r 


The 

horegr 

ound 

Color is the < 

col or x n 

wh i 

c:h 

t h e 

> charac- 

ter 

i s d i s 

p I ay 

ed ,4 






Esc: a 

.p0--b m 

ust 

b e f 0 11 cd w 0 d b y 

a color 

sel 

ect 

i on 

i charac— 

ter« 

On I y 

the 

four least si 

gnifican 

t b x 

t s 

of 

the col or 

char 

acter 

are 

used s 







B x t P a 11 0 r n o f C o n t r o J. B y 1 0 5 

6 0 4 .!:* 2 1 1 

I : i i i 

i i 1 i i 

S X I X ! X ! X I color index 

» i i t j 

1 i 1 t * 

(X "don't care") 
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ES 6 c 

5 © t B a c k g r o u n d C o 3 . o r 

T h i s t u n c t i o n s © I © c t s B a c k g r o la n d l": o i o r , t h © c co i o r o f 

t h © c © 11 t l*”i a t c: o n t a :t n s t h © c hi a r a c t © r s„ 

E s c. a p © ~ c:: m u s t b © t o 11 a w © d b y a c: o I o r s e 1 © c: t i o n c: h a r a c. 

t © r . 0 n 1 y t h © f □ u r 1 © a s t s i g n i f i c: a n t b x t s o t t. h © c o I o r 

c h a r a c t © r a r © u i-a © d « (S © © cl i a g ram tor E S C—b f u. n c t i □ n ) 

ESC d 

El r a s © 0 © q i n n :*. n g o t D i s p I a y 

T h i s s © q u. © n c © © r ax s © s f r o m b © g x n n i n g o t t h © cl i s p I a y t o 

t h © c u r s o r p co s i t i o n« T h © c u r s co r p o s x 1 1 o n i s © r a s © d 

al so. 


ESC © 

EnabI© Cursor 

T h x s s © q u © n c: © c a u s e s t h © c u r s o r t o b © i n v i s i b I e« T h e 

c u r s o r rn a y s t i 11 b © m co v © d a b o u t o n t h © d1 s p i a y , u s i n g 

© s c: a p © s e c:{ u © n c © d © t x n © d i n t h x s a p p © n d i x „ 

E 1 SC t 

D i s a b i © G u r s o r 

Thxs sequence causes the cursor to be xnvisibi©„ The 
c u r s o r m a y s t i 3.1 h © m o v © d a b o u t o n t h © ci x s p 1 a y , u s :i n g 
© ci. c a p © s © q u © n c:: © s d © t i n © d i n t h i s a p p © n d i x » 

ESC j 

S a v © C u r s o r P o s x t i o n 

T h i s s © q u. © n c © p r © s e r v © s t h © c u. r r © n t c u r s o r p o s i 1 i o n « 
Y o u c ax n r © s t o r © t h © c u r s o r t o t h © p r © v i a u s 1 y is ax v © cl 

p o s 1 1 i □ n w 1 1 h El 8 C - k „ 


ESC k 

R © s t o r © C u r s o r P o s i t i o n 

T h i s s © q u © n c: © r © s t o r © s t h © c u r s o r t o a p r © v i o u s l y s a v © cl 
p o s i t x o n is I f y a u u s © t h x s s © q u © n c © w i t hi o u t h a v x n g p r © ••• 
v x o u s i y s ax v © ci t h © c t.i r s o r p o s x t i o n ,, t h © n t h © c lx r s o r x s 
rn o v © ci t co t h © h o m c? p o s i t i o n t In e t o p 1 © 11 h ax n d c o r n © r co f 
the screen„ 


E r a s © E n t i r © L i n e 

T hi x s s © q u © n c © e? r a e? s- a n © n v: i. r © 1 i n © a n cl rn co v e s 1 : h © c u. r -- 

s o r t o t h © I e 11 m o s t c o 1 u m n 


E r ax s © 8 © g i n n x n g o t L x n 

E r a s © s t r c« rri t t i © b cv q i n n i. n g o i t h © l i n © t o t hi © c u r s o r a n d 

i n c I u ci © s t h © c:: u r s o r p o s i t x co n « 

iz. C Lf p 

E n t © r R e? v e r s © v i cl e: d li co d © 


A t a r x C o r p « C co n t : x ci e n t x ax I 
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i::i. n t e r s t h e r e v e r s © v i d e o m o d e s o t h a t c h a r a c t e r s a r e 
d i © p I a y e d a s to ak g r o u n d c o 1 o r c h a r a c t e r s o n a f o r ©— 
g r o li n d c o 1 o r e d c e i. 1 « 


EBL g 

E x i t R 0 v e r s b V i d e o M o d e 

Ei x i t s t h e r e v e r s e v i d e o rn o d e« 


ESC v 

N r a p a t El n d o t L.. :i. n © 

I h i s s © q u © n c: © c a u b © s t h © f ; i r s t c h a r a c: t e r p a s t t h e l a © t 

d i b p 1 a y a h 1 © p o s i t i c« n o n a 1 i n e t o h e a li t o m a t i c a 1 i y 

p 1 a c e d i. n t h © t i r 1 c h a r a c t e r p o s i t i o n o n t h e n © x t 

]. i n e« 1 h e p a g © s c r o i 1 s u p i t n e c 0 s s a r y« 


ESC w 

D i s c a r d a t E." n d o t L i n 0 

F o 11 0 w i n g 1 n v 0 c: : a t i 0 n 0 f t h i s s 0 q u 0 n c 0 H a 11 0 r t h 0 I a s t 
d 1 s p 1 a y a h !l. 0 c: h a r a c 1 0 r 0 n a I :i. n 0 h a s h 0 0 n r 0 a c h 0 d ,, t h 0 
c h a r a c t e r s 0 v 0 r p r i n t» T h 0 r 0 f 0 r 0 «, 0 n 1 y i:: h 0 1 a s t c: h a r a <::: - 
t © r e c © i v 0 d i s d i s p I a y 0 d i n t h 0 I a s t c o 1 u m n p 0 s i t :l o n ,, 


nt ar i 


C 0 r p n C 0 n i : i d 0 n t i a i 
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T' h i s p a g e u n i n t e n t :i. o n a i J. y 
1 eft blank« 


D cd c la rn e n t a t i o n o n p r t b 1 k () g o e s 
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HERE! 
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Inter rupts 
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T r a p s „ X n t e r r u p t i-s- a n d X n t e r r u p t V e c t o r s 


The ST makes use of tour of the sixteen TRAP vectors pro- 
v i d e d h y t h e 68000« A1 X o t h e r t r a p ns a r e a v a i X a b X e t a r 
ap p X :i c at X on s „ 

Trap Use 


0 (none) 

1 6 E T1D 0 S i n t e r f a c e 

2 D 0 8 e x t e n s i o n s (8 E11 „ 6 8 X ) 

3 (none) 

4 (none) 

5 (none) 

6 (none) 

7 (none) 

8 (none) 

9 (none) 

10 (none) 

IX (none) 

12 (none) 

13 BIOS 

X 4 A t a r i &10 S e x t e n ns i o n s 

15 (none) 


6 & 9 0 1 i n t e r r u p t s a r e* b a s e d a t T10 0« T h e s i x t e e n X o n g w r:.) r d s 
a t t h i s i o c a t i o n a r e b o u n d b y t h e h a r d w a r e t 0 s 


Vector 

FunctX on 

T100 

< d X s a b X e ci) P a r a X X e X p 0 r t X n t „ 

104 

< d X s a b X e d ) R S232 C a r r X e^ r D e t e c: 

'$ 108 

(d X ns a b 1 e ci) R8232 CI e a r — T 0 - 8 e n d 

:iji ; 1 0 C 

(d X sabX ed) 

$ 1 1 0 

(dX sabXed > 

1 1 4 

200h z S y s t e m c X 0 c {•:*. 

:$•! 18 

K 0 y b c.3 a r d / M X D X C 6850 J 


T11 c < d i s a h X e d) P o X 1 e d F D C / hi D C 

“!•* 120 HSync ( 1 n i t i aX X y d i sab X ed) 

$ 12 4 R S232 t r a n s m i t e r r o r 

T12 8 R8232 t r a n s rn i t b u. f + e r e m t p y 

12 c R E>232 r e? c e X v e e r r o r 

T 13 0 R8232 r e c: e i v e b u f t e r t u X X 

$ 1 3 4 (d X s a b X e d ) 

•t i. 3 8 (X ns a b X e d ) R8232 r 1 n g X n d X c a t o r 

T" 1 •:!* c i. d X s a id X e d ) P o X i e d rn o n i t o r t y p e 


A t a r X C o r p « C o n t i. d e n t X a X 
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T h e d i v i d e • b y ~ z e r o v e c: t o r i s p o :i. n t e d a t a n R T E » 

All other traps (Bus Error, et al) are pointed at a handler 

t h a t d u. rn p s t h e p r o c e s s o r s t a t e a n d a 11 e m p t s t o t e r rn 3 . n a t e t h e 

atrren t process. II Sees System In 1 1 i a I i zat i on II 

I he Li ne 1010 i “ L:i. ne Aye 33 ) vect or i s used as a shor t--c: i rcu1 1 
around the VI) 1 to the SI s graphics primitives. It is a 
p o w e r t u I a n d u s e f u 1 i n t e r t a c 05 s 0 0 t h 0 L i n 0 A d o c: u m 0 n t t o r 
•f u r t h 0 r 3. n f o r rn a 1 3. o n« 

T h 0 1 - i n 0 .1. 11 i < 3 1 L i n 0 E 11 31 ) t r a p i s c la r r e? n 11 y b e i n g u s 0 a 
i n t e r n a 1 1 y t o t h 0 s y s t e rn« I f y o u f i d d 1 e w i t h t h i s v e c: t o r 
t h 0 A E S w 1 3.1 b r 0 a k „ 

T h 0 F D C / H D C i n 1 0 r r u p t rn a y b 0 0 n a b 1 0 d b y a h a r d d 1 s k d 0 v i c 0 

d r i v e r .. T h e -f i o p p y d i s k c: a d e , h a w 0 v e r, a s s u m e s t h 1 s 3. n 1 0 r ••• 
r u p t i s d i s a b 1 0 d < i t b u s y - w a i t s o n t h 0 i n p u t b i t s s t a 1 0) „ 

II i s 11 "! e r 0 <5 p o n s i b i 1 i t y o f o t h 0 r d r i v 0 r s 1 n t h 0 s y s 1 0 m t o 
0 n s u r 0 t h a t „ w h 0 n t h 0 f 1 o p p y d :i. s k r e a d / w r i 1 0 /1 o r rn a t c o d 0 
g 0 1 15 c o n t r o I , t h 0 F D C / H D C :i. n 1 0 r r u p t i s d i s a Id 1 0 d„ 

T h 0 p r o c 0 s s o {-• n o r m a 1 i n 1 0 r r u p t p r 1 o r i t y 1 0 v 0 1 i s 3 « T h i s 
1 s t o p r e v e n t H B L. A N K (a u t o v 0 e t a r I e v 0 1 2 ) i n t0 r r la p t s t r o rn 
o c: c u r r i n g o n 0 v e r y s c: a n I i n 0« II 11 w o u 1 d 0 a t a b o u t 10 X o f a 
s y s t e m r u n n 1 n g i n a c: o 1 o r g r a p h 3. c s m o d e «, o r a b o u t 2 2 X o t a 
s y s 1 0 rn r la. n n 1 n g i n rn o n o c hi r o rn 0« v la c I---:„ II T h e? d 0 f a la 1 t H B L A N K 
i n 1 0 r r u p t h a n d I e r rn o d i f i 0 s t h 0 i n 1 0 r r u p 1 0 d p r o c 0 s s I F‘ L t o 3 
a n d p» 0 r t o r rn s a n R T E„ T h 3. s i s t o d i s c o la r a g 0 p r o g r a rn s t r o rn 
using I PL 0 . to use HBLANK, use an I PL of i„ 

]" o p r 0 v 0 n t 3 3 j i t1 b r i n g 3 3 i n p r o g r a rn s t h a t c:: h a n g 0 s c r 0 0 n c: o I o r s 
o n t h 0 t 1 y , u. s i n g t h e H B L A N K ax n d H S Y N C i n t e? r r u p t v 0 c t o r s , 
t h 0 f : o j. 1 o w i. n g h a c k w i 3. i k 0 0 p 11"! e? s y s 1 0 rn 3. n t a c t a n d s 1111 
y i e 1 d a s o 1 1 d d 1 s> p 1 a y s 

LI 1 II R e.v e c t c::» r t h 0 k y b o a r d / IIIDI 1 n 1 0 r r u p t t o a r o u t i n 0 

t h? a t I o w 0 r s t h e 1 F* L... t o 5 a n d t h 0 n j u m p s t h r o u g h t h 0 
o r i g i n a 1 v 0 c t o r „ 

II 2 II D u r i n g t h 0 31 c r i 11 c: a 1 3 3 s 0 c t i o n o t t h 0 s c r 0 e? n ,, r 0 - 
vector the 200 hz system cl ock i interrupt vector to 
p o i n 1 t o a r o u (: i n 0 t h a t i n c r 0 m 0 n t s a c o u n 1 0 r a n d 
R T E s. 11 ’i 0 c o un 1 0r k 0 0 p s t r a c k o t t h 0 n u mh er o t s y s- 

1 0 m t i c k s t h a t o c c u r c:l la r i n g t h c r i t i c a I s 0 c: t i o ri „ 

II 3 II A f 1 0 r t i ‘i 0 c r i. t i c a 1 s e) c t i o n , b 1 o c k i n 1 0 r r u p t s (a t I p L 
6 ) a n d c a j. I t h e s y 1 0 rn c 1 o c k h a n d I 0 r (J M P t h r o u g h t h 0 
i n 1 0 r~ r u p t v 0 c t o r «, w i t h a f a k 0 S R a n d r e t u r n a d c*i r 0 s s 
o n t h 0 s t a c k ) t h 0 n u rn b 0 r o t t i rn 0 s i n d i c: a 1 0 c 3 b y t h 0 

counter„ 


h t a r 1 C o r p „ C o n f i cl 0 n t i a I 
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8 y s 1 0 m V a r i a b 1 a s 


ihis is a iist of variah1es in tbe ST BIOS that have been 
£ 1 c a s t i n c a n c r e t e n „ 1 h e x r 1 a c:. a t 1 □ n s a n d m e a n i n q s i n 

t u. t u r e r e v x s i o n s o f t h e S T B10 S a r e q u a r e n t e ev cl n o t t o 
change* 

A n y c:« t h e r v a r x a b 1 e s :i. n 
t d r s b e i d w 400 fc h a t 
e r t a x n t o c h a n g e „ 11 

u n d o c u. m e n t e d v a r i a ta 1 e s 

e t v t :l hi e r ( 1 o n q ) 4- 4 0 0 

T i rn e r h a n d c> -f f v e c t o r < 1 o q i c a I v e c: t o r $ 10 0) S e e 0 E I T ~ 

D 0 8 d o c u m e n t a t x o n * 

e t v c r :l. 1 i e: (1 o n q ) # 4 0 4 

C r x t i c a 1 e r r o r h a n cl o f f v e c t o r (1 e g i c a 1 v e c: t o r $ 10 1 ) „ 
S e 8 E IT D 0 8 d o c: u m e n t a t x o n„ 


R A IT , r o u 1 1 n e s i n t h e R 0 I T „ o r v e c: — 

a r n o t cl o c u rn e n t e d h e r e a r e a 1 rn o s t 

x s i rn}::) o r t a r*i t n o t t o cl e p e r i d o n 

or ROM 1 oc:at x ons „ 


e 1: v.t e r h’i (1 o n g) $ 4 0 8 

l ;: ‘ r c::» c: © s s ~~ t e r m i n a t e h a n c:J o 11 v e c t o r (1 o g i c: a i v e c: t o r 

1- 10 2 ) « S e e G E IT D 0 8 d o c u m © n t a t. i o n .. 

e t v. :■< t r a ( i o n g e-) :i|i : 4 0 c: 

8 p a c 0 t o r I o g i c a I v e^ c: t o r s 10 3 t h r o u g h # i 0 7) ,, 

rn 0 m v a I i d (1 a i"i g ) m $ 4 2 0 

Can tax ns the magi c: number $ 7520 :L 9 F 3 „ wh i ch (together 
w i t h ‘ m 0 m v a 12 ' ) v a i i d a t e s m e m c: n 11 r a n d x n d x c a t e -ib a 
s u e c:: e s s t u. i c cj 1 d s t a r t «. 

m e m c: n 11 r (i:) y t e) # 4 2 4 

C o n t a x n s m e m o r y c: o n t r o i I e r c: o n f x q u r a t i o n n x b b 1 e ( t hi e 
I o w n i. i::« b 1 e) F o r t h e t u. 1 i s t o r y s e e t h ca hi a r d w a r e 
rn a n u. a .1. u E> o rn e p o p u i a r v a 1 u. e s a r e r, 

Memory size 
i 28 K 
512K 

256K (2 banks) 

11TB (2 banks) 


r e s v a 1 x ci (1 o n g ) $ 4 2 6 

i t r e s v a X i cl x s t h e rn a q x c n u rn b e r 3 i 4 i 5926 o n s y s t e rn 
R E 8 E 7 t h e s y s t e rn w i i. 1 j u rn p t: hi o u g h r e s v e c t q r » 


Va 1U0 
0 
4 
0 


A t a r x C o r p „ C o n t i d © n t i a 1 
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r e ns v 0 c t o r (1 o n q) 4 2 a 

S y s t e rn ••••• R E 3 E T b a X 1 o u t v 0 c: t o r , v a 1 i d i f r 0 s v a i :i. d i s a 
it i a g i c: n u m b 0 r » C a 1 1 e d 0 a r 1 y - o n 1 n s y s 10 m .1 n i t i a I i z a 
t i o n < I::) 0f o r e / a? n y / h a r d w a r e r e* g X s t e r s h X n c 1 u d i n g 1 h 0 

rn 0 m a r y c a n t r o 1 10 r e o n f i g u r a 11 o n r 0 g i s 10 r „ h a v 0 b 0 0 n 
t o u c: h 0 d ) „ h r 0 1 u r n a d d r e s s w i 11 b 0 1 o a d 0 d :i. n t o A 6 „ 
B o t h ns t a c k p 0 X n t0 r s w X 1 1 c o n t a :i. n g a r b a g 0. 

P h y 1 :'::* t O p ( 1 O H Q ) $ 4 2 0 

F‘ I"! y s i c a I t o p o f R A Id» C o n t a X n 0 a p o X n 1 0 r t o t hi 0 f i r s t 

u n u s a Id 1 0 b y 1 0 (1 „ 0« 8 0000 o n a 5 1 2 K m a c: h i n 0) « 

.m 0 rn b o t (I id n g ) # 4.3 2 

8 o 11 o rn 0 f a v a X 1 ax h I 0 rn 0 m o r y „ T h 0 g 01 m p b B 10 E> f u n c 
t i o n u. s 0 s t h X s v a 1 u e a s t h 0 s t a r t o f t h 0 G E. M D 0 S ! P A a 

rn 0 m t o p < i. o n g) $ 4 3 6 

T o p □ f a v a i I a b 1 0 rn 0 rn o r y „ F h 0 q 01 m p b B 10 E> f la n c: t i o n 

la s e s t h i s v a 1 u 0 a s t h 0 0 n d o f t hi 0 G E. Id D 0 S I P A » 

rn 0 m v a i 2 (1 o n q > :$• 4 -3 a 

C o s" i t a :i. n s t h 0 rn a q i c: n u m b 0 r 237698 A A w h i c h (t o g 0 1 h 0 r 
w i t h m 0 rn v a 1 i d > v a X i d a 10 s rn 0 m c n t X r a n d 1 n d i c a 10 s a 
s la c c: 0 ns s t la i. c: o .1. d s t a r t „ 

f !!. o c k (w 0 r d) ^ 4 3 0 

Li s 0 d t o X o c: k li s a g 0 o i : t h 0 0 M A c h i p „ E> hi o li 1 d b 0 

nonzero to ensure that the 08 does not touch the Did A 
c h i p r 0 g i s 1 0 r s d u r i n g v 0 r t i c: a 1 b X a n k « D 0 v i. c 0—d r i v e r 
writors TAKE NOTEs this variabl0 MUST be nonzero in 
order to make Lise of the DMA bus. 

•;b e 0 k r a 10 (w o r d ) 4 4 0 

D e f a la 11 f ; X o p p y s e e k r a t e« B i t s z 0 r o a n d o n 0 c: o n t a i n 
t h 0 d 0 f a la 11 f X o p p y d X s k s 0 0 k r a 1 0 f o r b o t hi d r i v 0 s 2 

00 
01 
10 
1 X 


t i rn r rn s < w o r d) 4 4 2 

S y s 1 0 rn t X rn 0 r c a X X b r a t X o n (X n rn s > » E> h o u X d b 0 T :; X 4 (2 0 

d 0 c 1 rn a i. ) , s 3. n c 0 t h 0 t :i. rn 0 r h a n d o f t v 0 c t o r X s c: a X X 0 d a t 

5 0 h z « R 0 1 u. r n e d b y B X 0 9 f li n c t X o n . t X c k c a X r „ a n d 

};:3 a s s 0 d o n t h 0 s t a c k t o t h 0 t X rn 0 r h a r"i d o f f v 0 c: t o r . 

f v 0 r 1 t : y < w o r cl) 4 4 

F J. o p p y v e r 1 f y t- J. a q „ W h*10 n n o n z 0 r o H a X X w r X 1 0 s t o 

•f i. o p p 1 0 s a r e r 0 a d.v 0 r X f :i. 0 d. W h 0 n z 0 r c:« 9 n o w r 1 1 0 •*- 

v 0 r 1 f i e t a k 0 p J. a c eT h e d e f a la X t s t a t e •; a f t e r 
y is 1 0 m—r 0 s 0 1 ) x i : i> t o v 0 r X f y.. 


6ms 
X 2 ms 
2 ms 

3 ms [default! 


r t a r :i. C o r p «, C o n f X d e? n t X a 1 
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b o o t d e v < w a r d ) 4 4 6 

C o n t a i n s t h e d e v x c e n ix rn b e r t h e s y s t e rn w a s h o o t e d 

f r o rn« T h e B10 S c o n is t r u c t s a n e n v x r o rn e n t s t r i n g t r o rn 
t h x s v a r x a b 1 e b e t o r e b r x n g x n q u p t h e d e s k t o p „ 


p a 1 m o 0 (w o r d ) $ 4 4 8 

W h © n n o n z e r o ,, x n d x c a t e s t h e s y s t e m x s x n P A L. 
v x d 0 o) rn o »d e« W h e n z e r o «, x n d x c a t e s t h e s y is t e rn 
N T S C (6 0h z v x d e o > mod e.. 


(50hz 
x s x n 


d e f is h i f t m d (b y t e) $ 4 4 a 

D e f a u I t v x d e o r 0 s o 1 u t x o n 
c h -a n g e f r o m rn o n o c h r o m e 
d 0 f s> h x f t rn d c o n t a x n s t hi e 
is wx tch to» 


l f t h 0 si- y 31 e rn x s f o r c e d t o 
rn o d e 1.:. o a c o 1 o r r e s o 1 u t x o n „ 
r 0 si- o 1 u t i o n t h © s y s t © rn w x 11 


sshxftmd ( 

Contax ns 




r Qj $4 4c 
shadow for 


hi f tmd 


hi a r d w a r © r e g x is t e r s 


0 320k 200x 4 (1 o w r e s o 1 u. t x o n 

1 6 40x 200x 2 < m © d x u m r © z ) 

2 640x 400x 1 < h x ci h r e z / 51 rn o n o c h r o rn e ‘ *) 


.v _ h a s a d (I o n g ) 4 4 e 

i ;:: ' o i n 1 0 r t o b a rs. e o f s c r e e n m e rn o r y „ f h 1 w a y s o n a 512 - 

b y t © b o u n d a r y« A1 w a y s> p cz x n t nr> t o 3 2 K o f c c::* n t x g u. o u s 

memory 

v b 1 is e m (w o r d) 4 5 2 

8 © m a p h o r e t o e n h o r c e rn u t u a J. e x c i u s i o n i n v ei- r t x c a .1.. 

b 1 a n I *.; x n t e r r u p t h a n d i © r „ 8 h o u i. ci b e 1 t o e n a b 1 © 

v b 1 a n k pj r o c: e s s x n g ,, 

n v b 1 s (w o r d ) $ 4 5 4 

N u rn h.:< e r o f .1. o n q w o r d s t h a t v b 1 q u. e u e j:::» o x n t rs t o „ «; 0 n 

R E*. S E1 « d e f a u i t s t a 8) « 

.v b 1 q u 0 u e (.1 o n g ) # 4 5 6 

F 1 o i n 1 0 r t o a v © c t o r o f p c j x n t e r is t o v b 1 a n k hi a n d J. e r rs „ 

c o 1 o rt r (I o n g ) 4- 5 a 

Pox nter to a vecr.tor of 16 words to i oad x nto the 

h a r d w a r e p« a i. e 11 © r e g i s t e r s o n t h e n e x t v b 1 a n k « I f 

H U L... L t h e p a 1 0 11 e s a r e n o t i o a d © d n c o 1 o r p t r ; i s> 

z 0 r o 0 ci a f t ee r t h p a 1 e 11 © is a r e 1 c:» a ci e d „ 

s c r e © n p t (I o n c^ > $• 4 5 e 

P o x n 1 0 r t o t h 0 b a s> © o f s c: r e © n rn © rn o r y ^ t o b e s e t u p o n 

t h © n e x t v b 1 a n k * I f N Li L L , t. h e s c r e e n b a is © i is n o t 

changed„ 

.v b c I o c k (1 o n q ) $ 4 6 2 


r t a r x C o r p « C o n t : x ci e n t x a 1 
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C a u n t o f v e r t :i. c a i - b I a n k i n t e r r u p t s. 

_ . f r c I o c::: k (I o n g) $ 4 6 6 

C o u n t d f v 0 r t i c a I.b i a n k i n t e r r u p t s t h a t w e r e p r o - 

c 0 s s 0 d (n o t b i o c k 0 d b y v b 1 s e rn j „ 

h d v.i n 1 1 (J. o n g ; ■$ 4 6 a 

V e c t □ r 1 o h a r d d x s k x n .i. t x a i x z a t x o n „ N U i...!.... i f u n u. s e d „ 

s w v.v e c (1 o n g) 4 6 e 

f h 0 b y s 10 rn t ex 11 o w s t h i s v e c t o r w h e n x t c:i 010 c t s a 

t r a in 0- x t x o n o n t h e ' 1 m o n o c h r o m 0 m 0 n x t o r d 010 c t 11 x n p u t 

(4 r o m i o w t ex I"! x g h r 0 z , t 0 r v x s a - v 0 r s a; » 0 w v v 0 c: 

i n x t x a 11 y p o x n t s t 0 t h 0 s y 1010 m r 0 s 0fc h a n d 1 0 r 5 t h 0 r 0. 

f a r 0 t hi 0 s y s 1 0 m w x I J. r 0 0 0 1 x f t h 0 u s 0 r c h at n g 0 s rn 0 n x — 

tors- 

h d v b p b (1 0 n g ) $ 4 7 2 

V 0 c: 10 r t o r 0 u t x n 0 t o r e t u r n a h a r d d 1 s k s & x 0 s P a r a rn. 

010 r B 1 0 c k (B P B) « 8 a m 0 c a 11 i n g c: 0 n v e n t x 0 n s a is t h e 

B 10 S f ix n c t x 0 n f : cz r 8 E T B F' B.. N U L L :i. f u n u s 0 d „ 

i ”i d v r w (1 o n g) 4 7 6 

V 0 c 1 0 r 1 0 r 0 u t x n 0 1 0 r 0 at d 0 r w r 3. 1 0 0 n a h a r d d x s k „ 

S a rr^ 0 c: a 11 i. n g c 0 n v 0 r - ! t. i o n a a s t h 0 810 8 f u n c t x 0 n f 0 r 

R W A B 8 „ N U L L x f u r "i u s 0 d » 

hi cj v.b a 0 1 (1 0 n g ) 4 7 a 

V 0 c: 1 0 r 1 0 r 0 u t x n 0 1 0 b 0 0 1 f r c:> rn h a r d d x s k « N (J L. L. x t 

unused« 

h d v rn 0 d i a c h (I 0 n g ) # 4 7 0 

V 0 c: 1 0 r 1 0 r 0 u t i n 0 1 0 r 0 1 u r n a h a r d d i s !•:; s rn 0 d x a 

change mode- Same as BIOS binding for floppies,. 

NULL xf unused» 

.c rn d 1 o a d (w 0 r d ) 4 8 2 

W h 0 n n 0 n z 0 r 0 a r i a 11 0 rn p t x s rn a d 0 1 0 1 0 a d a n d 0 ;•? 0 c u 1 0 
C 0 M li A N DP R G f r o m t h e b 0 cx t ci 0 v i c e« (I-., o a d a s h 0 11 0 r 

a n a p p 1 :i. c: a t x 0 n x n p 1 a c 0 a t t h 0 d 0 s !•:; 1 0 p ) ,, C a n b 0 s 0 1 
t o n 0 n z 0 r 0 to y a b o ex t s 0 c t cx r » 

c 0 n 1 0 r rn 1 b y 1 0 > 4 8 4 

C ex r i t a x n s a 11 r i b u 1 0 b x t s i : ex r t l“i 0 c: 0 n s 0 J. 0 s y s 1 0 rn s 

Bx t Functx on 

0 n o n z 0 r 0;; 0 r\ a to 1 0 to 0 11 w h 0 n • • 6 i s w r i 11 ex r 's t ex C l J h i s 

1 n ex {” i z 0 r 0 s 0 n a to 1 0 k ex y • • r 0 p 0 a t 

2 n ex n z ex? r 0 n ex? n a to 1 ex? k ex? y—c 1 i c k 

3 n 0 n z ex r p s ex n B 1 □ S c: o n i n () f u n c t x ex n , r e t u r n t h ex? 

c u r r ex n t v a 1 u ex? 0 f k to s h i f t i n to x t s 

24 . .31 of DO« L« 

z ex? r 0 s 1 ex a v ex? to x t s 2 4 « . 31 a 1 o n ex „ „ „ 


A t a r i C ex r p . C o n f i c j e> n t i a 1 
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t h e rn d ( 1 o n g ) $ 4 8 e 

F i 11 e d i n b y t h e B1 0 8 o n a q e t m p b c a 11 ; i n d i c a 1 e s 
to GEMDOS the limits of the TPA« The structure iss 


HD 




HD 

*m.1 i nk 3 

/ •*- 

->next MD C NULL II */ 

1 ong 

rn.start 3 

/ 

s t a r t 0 f T P A * / 

1 ong 

rn.i ength ;i 

/ 

s i z 0 0 f T i ::: ' A (b y 10 s) 

PD 

*m_own 

/ 

- > M D s n w n e r f' N U L L 3 


T h e s t r u c t u r e m a y N 0 T b e c: h a n g e d o n c e G E M D 0 S h a s b e e n 

i n i t i a 1 i z e d 1 n a d d i t :t o n , t h e r e m a y b e o n 1 y 0 N E o f 


t h e ■£*:- e s Li c k 0 r s (v o u c a n t 
t h 0 f i r s t i i D) S o m e d a y 
t h 0 s e 1 i rn i t a t i o n s m a y b 0 

s a v p t r C1 o n g ) $ 4 a 2: 

F' o 1 n t. 0 r t o r 0 q :i. s 10 r s a v e 


use Eh® rn J. i n k f i el d i n 
t h 0 s e < w i t h a b 011 e r G E M D 0 S > 
1 i f ted „ 


a r 0 a f o r B 10 S f u n c t i o n s« 


n f 1 o p s ( w o i'" d ) ’$• 4 a 6 

N u m b 0 r o f f 1 o p p y d 1 s k s a c t u a i 1 y a 11 a e h e d t o t h 0 s y s 
tern (0, 1, or 2)- 


3 a v.c o n 1 0 k t J. q n q $ 4 a 0 

P o 1 n 10 r t o s a v 0 d p r o c 0 s s o r c o n 10 x t (m o r 0 o n t h i s 
later) » 

_ b u f 1 <1 o n g ) # 4 b 

I w o < 6 E M 0 0 S) b u f f e r -1 i s t h e a d 0 r s« T h 0 f i r s t 1 i s t 
h u f f 0 r s d a t a s e c t o r s , t h 0 s 0 c o n d 1 i s t h u f f e r s F AI a n d 
d :i. r 0 c t o r y s 0 c t o r s a E a c h o f t h 0 s 0 p o i n 10 r s p o i n t s t o 
a BCD (Buffer Control Block), that looks likes 


struct BCD 


BCB 

*b.1inks 

/ 

next BCB */ 

i n t 

b^bu.fdrv; 

/ * 

drive#, or -1 */ 

i n t 

b buttypn 

/ 

buffer type */ 

i n t 

b.butrec; 

/ * 

r e c 0 r d # c a c h 0 d h 0 r e * / 

i nt 

b.dirty3 

/ -ft- 

dirty flag */ 

DHD 

*b_dms 

/ * 

- > D r :i. v 0 H 0 d i. a D e s c r i p 1 0 r 

char 

*b butrs 

/ * 

.> b u f e r i t s 01 f * / 


2 0 0 

(J. ong) 

$ 4 ba 



Ravj 

200hz 

s y 10 m t i rn 0 r t i c: k „ 

Used to 

d 1 v 1 d 0.b y - f 0 Li r 

f or 

a boh z 

s y s t e rn t :t m 0 r « 




h 1 . a r 1 C o r p „ C o n f i d 0 n t i a 1 












s t e rn V a r i a b 1 e s A u g u. s t 26 , 1 985 

S e r i a I N u rn h e r O 0 h 7 3 8 


t h e 0 n v (b y t e 1 4 3 ) $ 4 b e 

T h e d e f a u 11 0 n v x r o rn e n t s t r x n g „ F o u r b y t e s o t T 0 0« „ „ „ 

.d r v b :i. t is < 1 o n g ) :£• 4 c 

3 2.b x t v 0 c: t o r , r e t u r n e d b y t h e * 1 D RIV E i i A P ! 1 810 S f u n c:. 

t x o n ( # 10} (| o f 1 * I i v e * 1 b 1 o c k d e v i c e s * 11 a n y f I a p p x e s 

a r e a 11 a c h e d ,, t h x s v a I u e i s 3» 

.d s k b u. f p (1 o n g) $ 4 c 6 

P o i n t s t o a 1024—b y t e d i s k b u f1 e r s a rn e w h e r e i n t h e 
s y s 1 0 m s B 8 8« T h e b u f f e r i s A L S G u s e d f o r s o rn e G 8 X 

g r a p h x c s o p e r a t x o n s , a n d s h o u i d n o t b e u s e d b y i n 1 0 r. 

r u p t r o u t x n 0 s „ 

.p r i. c n t (w o r d ) $ 4 0 0 

I n i t i a i i 2 0 d t d -1« F’ r 0 s s i n g t h 0 A L T - H E L P k 0 y i n c r 0 ••••• 

m 0 n t s t h x sT I" 10 s c r 0 0 n cl u m |:j c cd d 0 c h 0 c: k s f cj r $*• *D000 t o 

s t a r t i m a q i n g t h 0 s c: r 0 0 n t o t. h 0 ? p r i n 1 0 r , a n d c h 0 c: k s 

f o r n o n 2 0 r cx t o a b« o r t t h 0 s c r 0 0 n p r i n t. 

.s y s> b a s 0 < 1 o n g ) $ 4 f : 2 

Points to the base of the 08 (in ROM or RAM)« 

. s h 0 11.p ( i o n g ) $ 4 f 6 

P o x n t s t o s h 0 i j. - s p 0 c: i f i c:: c: o n 1 0 x t« 

e n d.o is C1 o n g ) $ 4 1 a 

Points just past the last byte of low RAM used by the 

o p 0 r a t x n g s y s 1 0 m,, T h x s i s u s 0 d a s t In 0 s t a r t o f t h 0 

T F ; - A (0 n d o s i s c. o p i & d x n t o rn e rn b o t) 

0 k 0 c.o s < 1 o n g) 4 f 0 

T h x s {:::«o x n t s t o t h 0 s h 0 i l t h a t g 0 1 s 0 k 0 c d b y t h e & 10 8 

a f 1 0 !'" s y s t e m i n i t i a 1 i z a t i o n i s c: o rn p:« 1 e 1 0 • M o r m a i 1 y 

t h x s p o i n t s t o t h b f x r s t b y t e) o t t h 0 A E 8 ' 1 0 x t s 0 g - 

men t „ 


POST MORTEM INFQRMATION 


1 f a d x a g n o s t .i c: a r t r i d g 0 i s n o t i n s 0 r t e d ^ a 1 i 6 * u n u s e d 1 ‘ 
x n 1 0 r r u p t v 0 c t o r s a r 0 p o x n 1 0 d t o a h a n cl 1 0 r x n 11 "i 0 B10 8 


A t a r i C, o r p « C o n f i d e n t x a 1 
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t h a 1 s a v 0 s t h 0 p r o c: 0 0 s o r s s t a 10 i n 1 o w rn 0 rn o r y (0 e 0 
b e I o w > a n d d i s p 1 a y s a n u m b 0 r o f' i c o n s i n t h 0 m i d d 1 0 o f 
th0 sc;r000 ,, The handi er attempts to r0start th0 system 
a f 1 0 r t h 0 c r as h - ~~ i t i s n o t a 1 w a y s (h o n e s 11 y 5 i t i s n ' t 
v 0 r y o 110 n > s u c c 0 s s t u 1 

T h 0 0 x a c: t n u rn b 0 r 0f i c: d n s r 0 p r 0 s 0 n t s t h 0 0 x c 0 p t i o n t h a t 

o c: c; u r r 0 d < 2 f o r b u s 0 r r o r H 3 t o r a d d r 0 s s 0 r r o r , a n d s o 0 n 

.- s 0 0 t h 0 E x c 0 p 1 1 o n P r o c 0 s s i n g s 0 c 1 1 o n .i. n t h 0 11 o t o r o 1 a 

68000 manual > ,, 

T h 0 p r 0 c 0 s s 0 r s t a 10 1 s s a v 0 d i n a n a r 0 a 0+ m 0 rn 0 r y t h a t i s 
NOT touched by a system reset« Therefore it is possible 

t o e x a m i n 0 a p o s t.rn o r 10 rn d u m p a f 10 r r 0 s 011 i n g t h 0 s y s 10 rn 

to reboot« 


* P 0 s t.rn a r 10 rn d u rn p a r 0 a 5 


* p r 0 c: e s 0 r s 

* 

t a 10 s a v e d h 0 r 0 

on 

u n c a u g h t e x c 0 p t i 0 n n 

— 

proc^j. 1 v 0 s 

equ T 380 

"$ 

123456 78 i f i v a 1 i d 

proc. dregs 

equ $384 


saved DO -07 

proc.aregs 

equ $ 3 a 4 

*1 

s a v 0 d A 0 “••• A 6«, s u p 0 r v i s 0 r A 

proc.enum 

equ T 3 c :4 

s 

f i r s t h y 10 1 s 0 x c 0 p t i 0 n # 

proc:.usp 

equ $ 3 c 8 

N 

*1 

saved user A 7 

proc.stk 

equ T 3 cc 

fi 

s i x t e e n w 0 r d s p 0 p p 0 d f r 0 rn 

I i : t h 0 1 0 ri g w 0 r d a t 

'$ 380 i s t h 0 rn a g i c: 

n 1..1 rn b 0 r 12345678 , 

t h 0 n t h 0 f 0 11 0 w i n g 

1 ri f 0 r m a t i 0 ri i s 

v a 1 

i d < tin 1 ess i t s been 


s 1 0 p p 0 d 0 n b y a n 0 1 h 0 r c: r a s h ) ,, 

D 0 •••- D 7 A 0 A 6 , a n d t h e s u p 0 r v 1 s o r A 7 a r e c: o p i 0 d 1 0 i o c a - 

t i 0 n s $ 3 & 4 t c:> 3 c 0« T h e 0 x c:: 0 p t i 0 n n u. m b 0 r (2 f 0 r b u s 

0 r r o ! •• " , e? t c « ) i s r 0 c 0 r d 0 d i n t hi 0 b y t e a t $ 3 c 4 „ T h 0 u s 0 r 

A 7 i s c: 0 p i 0 d t o $ 3 c 8» T h 0 t i r s t s i x 1 0 e n w 0 r d s a t t h 0 

s u. p 0 r v i s 0 r A 7 a r 0 c o p :i. 0 d t o t l ”i 0 s i x 1 0 0 n vm o r d s s t a r t i n g a t 

$3cc» 


Corp« 


At ar 1 


Confident 1 aI 
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,;>b 


G e t1 i n q I n t o a n d 0 u t G f 
S u p 0 r v i s o r ii o d e i n 6 f£ M D 0 E> 


D R1 n a s n t b o t h e r e d t o d o c u m os n t t h i s f u. n c 11 o n y os t, is o 


y e s h t h e r e 113 a w a y t o g e t i n t o < o r o u. 1 o f > s u p e r v 3. s o r 
m o d e i n G E M D 0 S» W h i 1 e y o u. r e a d t h e f o 11 o w i n g d e s c r i p — 
t i o n , p 1 e a s 0 b 0 a r i n m i n d t h a t t h e o r i q i n a 1 i n 1 0 n t w a s 1 0 
p r 0 v :i. ci e a b i n d i n g u. s a b 1 0 a t t h 0 C I 0 v 0 1 „ 11 i s c 1 u m s y t o 

u s 0 f r 0 m a s s 0 m h 1 y 1 a n g u a q 0 « 

The function is Trap i, number 32 (hex #20). It wears 
three hats a 


L 0 N G .s u p 0 r (s t a c:: k > 

LONG stack? 

1 f 0 1 a c k i s v/ ,, t hi en t h 0 f u n c t i 0 n r 0 1 u r n s 

ti. n D 0 „ L) e 1 1 h 0 r a 0 < i n d 1 c: a t i n g t h a t t h 0 p r o c e s s o r 1 s i n 
user mode) or a i n d 1 c a t i n g t h a t t h 0 p r o c: 0 s s o r i s i ri 
s u p 0 r v 1 s 0 r m 0 d e) „ 

I f t h 0 f u n c:: t i 0 ri i s c a 11 e d w h 0 n 1 h e p r 0 c: 0 s s o r i s i n u s e r 

m a d 0 , G IE H D 0 S w i 11 r 0 1. u r n w i t. h t. h os p r 0 c 0 s s 0 r 3. n s u p 0 r v i s o i " 
rn 0 c:i 0 „ T h 0 0 1 d v a 1 t.i 0 0 f t h 0 s u p r v 3. s o r s t a c I*:; w i j. j. b 0 
r 0 1 u r n 0 d i n D 0« L * I f ’ s t a c k ' w a s N U L L < $ 00000000) , t h 0 n 
t h 0 s u p 0 r v i s c:« r s t a c k w i 11 b 0 t hi 0 s a rn os a s t h 0 u s 0 r s t a c k 
b 0 f o r 0 t h 0 c a 11 „ 01 h 0 r w i s 0 t h 0 s u p 0 r v i 3 0 r s t a c k w i. 11 h 0 

set to stack » 

i f t hi 0 f u n c t i 0 r i i s c a J. 1 os d w h 0 n t hi e p r 0 c 0 s s 0 r i s i n s u p 0 r 

v i rs. 0 r m d os , G E M D 0 S w i i J. r 0 1 u r n w i t h t h 0 p r 0 c os s s 0 r i n u s os r 
rn 0 d 0 „ s t a c: i< s hi 0 u 1 d b 0 t h 0 v a 1 u 0 0 f t h 0 s u. p r v i s 0 r 

s t a c k t h a t w a is r os t u r n 0 d b y t. h os f i r s t c a 11 1 0 t h os f u n c 

t i on „ 

T h os 0 1 d va i uos of t hi 0 suposr vi sor st ac k MUST r est or e:g 

b 0 f a r os t h os p r 0 c 0 s 3 t os r m i n a 1 0 s „ (F a i 1 u r os t os d 0 s o m a y 

r 0 f::> u J. t 1 n a c r a s hi) 


A t a r 3. C 0 r p „ C o ri t ; i d 0 n t i a I 









u p 0 r v i o r H o d e 
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A n 0 x a rn p 1 e o t h o w t o u s e i t t r o m C s 

superstuff () 

. 1 . c:> n q s a v e s s p !{ 

1 ong trapi (>; 

/ ¥: 

•* b e t i n t d s u. p 0 r v i s o r m o ci e s 
# / 

s a v e _ s s p - t r a p 1 (0 x 2 0 , 0 L) ; 

. « « ci 0 1 o t s o 1* s u p e r v i s o r s t u f t 
/ * 

* 6 e t □ u t o f s u p 0 r v i s o r rn o d e, 

* r 0 s t o r e o I ci s u. p e r v i s o r s t a c: k 
¥: / 

t r a p J. (0 x 2 0 h s a v e s s p ) u 


A t a r :i. C o r p „ C o n f i d e n t i a i 








u p e r v i s o r hi o ci e 


And 


August 26„ 
Seri a1 Number 


1985 
006 738 


4 (j 


•f r g rn a s s e m b 1 y s 

•ft- "i" 

•* s u p e r s t u f t — p i a y a r o u n d i n s u p e r v i s o r rn o d e 

•?r 

— 

sup erst uf t r, 


do user stuff 


c .i. r . i 

— «, sp ) 

move - w 

#:$ : 2U ,.sp } 

trap 

# :L 

ad dq 

#6 , sp 

move* 1 

dO,savessp 

. do 

s u p e r v 3. s o r s t u f f 

move - i. 

save ssp „ - (sp ) 

move - w 

#'.$'•20 , — < sp ) 

trap 

# 1 

ad dq 

#6, sp 


do user stuff 


i; we want our own stack 
;; q e t / s e t s u}:) e r v i s o r m a d e 
r, < d d :i. t) 

; *clean up) 

save old SSP 


push old SSP 

; g e t / s e t s u p e r v 3. s o r m o d e 
(do it) 

; (clean up) 
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8 E ii D 0 S R e 1 o c a t i o n F o r m a t 
< C i a r i f i c a t i o n t o G E li D 0 S m a n u a 1 ) 


7 h i s i s t h e R E A L 0 E li D 0 S 11 x u p b y t e s t r e a m t o r m a t, a s 

i rn p 1 0 rn e n t e d b y t h e t u. n c t i o n x p g rn i d () i n G E li D 0 8 < a s 

o p p o s e d t o w h a t i s d o c la m e n t e d i n t h e 8 E M D 0 8 m a n u a I ) s 


#00 
#01 

#02 a a #FF 


n o m o r e r e I o c: a t i o n i n f : o r rn a t i. o i"i 
add #FE to the dot 

a d d N t o t h e d o t,, a n c:i f i x u p t h e? 1 o n g w o r d t h e? r e 


S o ^ t o f :i. x u p a 1 o n g w o r d # 10 0 b y t e s t r o m t h e c u. r r e n t n e 
i t h e ci o t) h R E L li 0 D w o u I d q e n e r a t & s 


# 0 : 1 . #02 


II n d t e t h a t. o n 1 y 1 o n ci w o r c.i s c a n b e *t : i x e d u. p a n d t h a t t h e y 

m u s t b e d n w o r d b o la n d a r i e s« 2 


A t a r i C d r p» C o n f i d e n t i a 1 
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E r r o r H a n d I x n q 


E r r d r n u rn b 0 r s a r 0 r 0 1 u r n 0 d b y c 0 r t a i n B 10 5 a n d m o s t G E i v l— 
D 0 S f u n c t i a n s „ N o 1 0 t h a t s o m 0 G E“ M D 0 8 f u n c t i o n s r 0 1 u r n 
W 0 E D e r r 0 r n u rn b 0 r is i n s 1 0 a d 0 1 L 0 N G o n 0 s (t h a t i s ,, bits 
:i. 6 „ „ 31 0 f D 0 « L. a r 0 g a r b a g 0 > « S o rn 0 ci a y 0 RI w i 11 g 0 1 a r o u n d 
t o f i k i n g 11 "! 0 0 e „ .. 

D 0 s c r i b 0 c r i t i c: a 1 • - e r r 0 r h a n d i 0 r c a 1 11 n g c: 0 n v e n t :i. 0 n 0„ 

whenever DR 1 gets around to defining them so they're use. 

f ul „ 3 

0 (OK) 

S u c c: 0 s s f u 1 a c: t i 0 n (t h e a n t i - 0 r r o r ) « 

. 1 (ERROR> 

A 1 1 {::) u r p 0 s 0 0 r r 0 r „ 

-2 <DRIVE.NOT_READY) 

D 0 v i c 0 w a s n o t r 0 a d y , 0 r w a s n 0 1 a 11 a c h 0 d , 0 r h a s 

b 0 e? n b u s y f 0 r a 1 o n g t x m e„ 

-3 (UNKNOWN.CiiD) 

D 0 v x c 0 d i d n t k n 0 w a b 0 u t a c: 0 rn rn a n d 
~4 (CRC.ERROR,* 

S 0 t t e r r 0 r w h i i 0 r e a d i n g a s 0 c t. o r „ 

. 5 (BAD.REQUEST) 

D 0 v i c 0 c: 0 u. 1 d n t h a n d i 0 a <::: 0 rn m a n d < t h 0 c 0 m m a n d rn i g h t 
b 0 v a 1 x d i n 0 1 h 0 r c 0 n 1 0 m t s) „ C 0 rn m a n d p a r a m 0 1 0 r s m a y 
be bad,, 

6 (8 E E l*'-:'..E R E 0 R > 

D r i v 0 c 0 u 1 d n t s 0 k * 

-7 <UNKNOWN.MED 1 A) 

A 11 0 rn p t 1 0 r 0 a d *f : 0 r i 0 g n m 0 cl i a < u s u. a i i y rn 0 a n s a c: 0 r 
r u p 1 0 d c« r z 0 r 0 b 0 0 1 s 0 c 1 0 r ) * 

-8 <SECTOR.NOT.FOUND) 

S 0 c 1 0 r c 0 u 1 c:i n cx t b e 1 o c a 1 0 d „ 

(NO.PAPER) 

P r i n 1 0 r :i. s 0 u t 0 f p a p 0 r (t h i s e: a n n 0 1 h a p p 0 n ex rx ci i s i c s H 

r x g h t ?) 


At ar x Corp ,, 


Cantidential 
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-10 (WRITE.. ..FAULT) 

F a i I u r e o n a w r 11 e o p e r a t i o n ,, 

- 1 1 (R E A D.F A U L T ) 

F a i 1 u r e o n a r e a d o p e r a t i o n „ 

- i 2 (GENERAL.MIBHAP) 

R e s e r v e d t o r f u t u r e c. a t a s t r o p h e s „ l T h i s s e e rn e t o b e 
a u s e 1 e s s e r r o r r i g h t n o w. 2 

-13 (WRITE.PROTECT) 

A11 0 rn q t 1 □ w r i t e o n w r x1 e - p r o t e c t e d o r w r 11 e - o n 1 y 
rned :l. a. 

-14 (NEDIA.CHANGE) 

f1 0 d 1 a c: h a n g 0 d 0 i n c: 0 1 a s t w r i 1 0 - - t h e o p 0 r a 1 1 o n (r e a d 

o r w r i t e) d i d N 0 T t a k e p 1 a c e „ (T h x s i s m o r 0 a m 0 s— 

s a g 0 t o t h 0 f i 1 0 0 y s 1 0 rn t h a n a r 0 a I 0 r r o r ) « 

-1S (UNKNOWN^DEVICE) 

0 p 0 r a t i q n s p 0 c i f ; i 0 d a d 0 v i c: 0 t h 0 B10 8 d 0 0 s n t k n 0 w 
a n y t h i. n g a b o u t „ 

-16 (BAD.SECTORS) 

F 0 r rn a t 0 p 0 r a t i 0 n s u c: c 0 e d 0 d < f 0 r t h 0 rn 0 s t p a r t) b u t 
y i 0 1 d 0 d b a d s 0 c: t o r s. 

-17 (INSERT.DISK) 

A s k u s 0 r 1 0 i n 0 r t a d i s k (t h i s i s rn 0 r e a rn 0 s s a g 0 t o 

t h 0 h 0 11 — G E M o r C 0 M M A N D« P R G — t o s t a r t a 

d ia1oug 0 w11 h th0 user). 


Atari Carp« 


Confx dentx a1 










44 


Cartridges 


A u q u s t 2 6 H 19 8 5 

S 0 r i a i N u. m b 0 r 00673(8 




C a r t r i ci g 0 8 u p p o r t 


I h e r 0 a r 0 t w 0 k 1 n d s o f c a r t r 1 d g e s „ A p p 1 3. c a t :i 0 n c a r — 

t r :i d g 0 s a r 0 r 0 c: o q n i z 0 d h y G E M a n d t h 0 d 0 0 k t o p « D i a q n 0 s ••••• 
t i e: c: a r t r 3. d g 0 s a r 0 0 x e c u 1 0 ci a 1 m 0 s t i m m 0 cl i a 1 0 1 y a f 1 0 r 

system reset (before the 68000 touches any RAM) „ and may 
t a k 0 0 v 0 r t h 0 0 n t i r 0 s y s 1 0 m» 

T h 0 S T h a r d w a r 0 m a p s c a r t r i d q 0 s p a c: e? t o a J. 2 £ 3 K r e q i 0 n 
star t i ng at $FA 0000 ex tend x ng to #FBF FFF« T he 1 ongword 
at FA 0000 has special meaning to the OS. It should be 
o n 0 o f t h 0 f 0 1 1 o w i n g 2 

4 :; F A 52255 F i n d i c a 1 0 s t h a t a cl i a g n 0 s t i c: c a r t r i d g 0 
i s x riser ted „ 

'$ A B C D F 4 2 i n d i c a 1 0 s t h a t a n a p p 1 i c: a 1 1 p n c: a r t r i d g 0 
i s 1 riser ted. 

anything 0 1 s0 is ign0red„ 

0 n s y s t e m R E 8 E T , 3. f a ci x a g n a s t x c: c a r t r x d g 0 x s 3. n s 0 r t e ci 

II " ! 0 0 8 w i .11 < a 1 rn 0 s t i m m 0 ci i a 1 0 1 y) j u rn p 1 0 1 o c a t i 0 n 

$*• F A 0004 „ A 6 w i. 11 c 0 n t a x n a r 0 1 u r n a ci d r e s s (s h 0 u i ci t h e 
c a r t r i d g e 0 v 0 r w i s h 1 0 c o n t i n u 0 w i t hi s y s 1 0 m i n i t i a 1 i z a - 
t x o n ) « T h 0 s t a c: k p 0 i n 1 0 r w i 11 h 0 g a r b a g 0 „ M o s t 0 1 t h 0 
S T ' s har dwar 0 r egi s 1 0r si- wi 11 n0 1 haxv0 been touc he ? d. T h0 

m 0 s t s i g n i t i. c a n t o t t h 0 s 0 r b g i s 1 0 r s i s t h 0 m 0 m 0 r y c: 0 n ~ 

t r 0 J. 1 0 r . t hi e d i a g n 0 s t i c: c a r t r 3. cl q 0 i s r 0 s p 0 n s i b 1 0 f 0 r 

s i z i n g m e rn 0 r y a n d i n i t i a 1 i z i n g t In e m 0 m 0 r y c 0 n t r 0 11 0 r « 

rx pi p 1 i c: a t i 0 n c ax r t r 3. cl g 0 s s h 0 u 1 c:l p r 0 v i. d 0 a p p 1 i c a t i 0 n 
Si 0 ax cl 0 r ‘ a t 1 0 c: a t i 0 n t- F A 0004 ( i m m e ci x ax 1 0 1 y f 0 1 1 0 w i n g t h e 
rn 3 .g 3. c: 1 0n g w0r cl) u An ap p lie at i 0n h 0axd er c: 0n t a i n s i n 1 0r ma••••• 

t x 0 n ax b 0 u. t ax n a p p 1 i c a t i 0 n i n E 0 M. T h 0 r 0 m a y b 0 a n y 

n u rn b & r 0 1 a p pi 1 i c ax t i 0 n s i n a c ax r t r i. d g 0« 


CARTRIDGE APPLICATION HEADER 


l 

I 

CA.NEXT 

I 

! 

t 

-1.. 

0 

~ > n 0 m t h 0 ax ci 0 r 

i 

i 

1 

CA.IMIT 

| 

i 

S 

4 

..> i ni t code 

i 

t 

1 

CA RUM 

1 

- 

8 

->run erode 

i 

i 

CA.CTI ME 

f 

i 

-- 

Tc: 

DOB time 


A t a* r i C 0 r p .. C 0 n i : i cl e n t i a 1 















C a r t r i ci q e s A u g u s t 2 619 8 5 

Serial Number 006738 

CA DATE { $e DOS date 


C A SI Z E 1 T10 ‘ 1 ize n o t a p p 1 . 


C A N A M E I -|i* 14 a s c i z n a rn e 

I (NNNNNNNN.EEE\0 > 


-4- 


a p o i n t e r t o t h e n e x t a p p lie: a t i o n h e a d e r . 1 1 

:ii :: 00000000 h t h e n t h e r e a r e n o m o r e h 0 a d e r s i n 


CA IN1 7 i s a p 0 i nte:r to th 0 appI i e:ati 0 n s i ni t i alizat i 0 n 

c 0 d 0 « 11 C A.INIT i s N U L.. L , t h 0 r 0 i s n 0 i. n i t i a 1 i 2 a t i 0 ri 

c: 0 d e« T h 0 i n i 11 a I i 2 a t i 0 n v 0 c:: 1 0 r i s c a 1 i 0 d a t s y s 1 0 rn 
s t a r t u p t i rn 0 „ a s c 0 n t r 0 1 1 0 d b y m a g i c: b i t s :i. n t h e h i g h 
to y t e 0 1 t h i s J. 0 n g w 0 r d (s 0 0 to 0 1 0 w > 

C A R U N i s a p 0 i n 1 0 r 1 0 t h e a p p 1 i c at t i 0 n s rn a i. n 0 n t r y 

point« 

CA.TIME and CAUDATE are DOS—format time and date stamps. 

[ T i "! 0 y a r 0 k i n d 0 f u s 0 1 u 1 1 0 r k 0 0 p i n g t r a c k 0 f v 0 r s i 0 n 
r”i u rn to e r s a n d t h i n q s 1 i k 0 t h a t ,, to u t a r 0 0 t h 0 r w 1 s 0 u s e 1 0 s s 

C A SI Z E i s a s i 11 y t i 0 1 d t h a t i s t h 0 

c: 1 10 n ■ II T h i s f i 0 1 d i s p 0 i n 11 0 s 

so 00 «..,«« J 

C A N AMEl i s t h 0 MUL L ™ 1 0 r m 1 n a 1 0 n ame 0 1 t h e ap p 1 :i. c:: at i 0 n „ 
11 s h 0 u J. d to 0 i n t h 0 s a m 0 f 0 r m a t a s a D 0 S a c: c 0 p t a to 1 0 

f i i 0 n a rn 0 n w i t h 0 u t a p a t h ( i „ 0 « u p 1 0 0 i g h t 1 0 a d i ri q c h a r. 

ac1 0 rs ,, 0 p t i 0 na 11 y 1 0 11 0 w 0 d toy a ei 0 1 anci up to thr 00 

c h a r a c 1 0 r s 0 f 0 x t e? n s i 0 n at n d a t i r"i a i. (4 U L. (T 0 0 > ) « 

T h 0 h i g h 8 to i t s < 2 4« « 31) 0 f C A _ IN11 h a v 0 s p 0 c: i a 1 m 0 a n 1 n g 2 

0 S> 0 1 1 0 e x e c u 1 0 a p p 1 i c a t i 0 n (t h r 0 u q h C A INIT v c — 

1 0 r ) to 0 f 0 r 0 i n t e? r r u p t v e c: 1 0 r s ti d i s p I a y m 0 m 0 r y 

( 0 1 c « ) h a v 0 b 0 0 ri i n i t i a i i z 0 cl 

1 - S 01 1 0 0 x 0 c: u 1 0 a p p 1 x c a t i 0 n (t h r 0 u g h C A.IN 11 v 0 c •••*• 

1 0 r ) j u s t to 0 f : 0 r e G EI M D 0 S i s i r"i i t i a i. i 2 0 d .. 

2 . (unused) 

3 . B 0 1 1 0 0 x 0 c: u 1 0 a p p 1 i c a t i 0 n (t h r 0 u q h C A IN1 7 v e? c 

1 0 r ) i m m 0 d i. a t e 1 y h 0 -f o r e a. ci i s k — to o o t „ il * * * F 0 R 

N 0 W * * * A p p 1 i cab I 0 1 0 to 0 0 1 R 0 M 0 n i y» II 

A t a v" i C 0 r p « C 0 n f :i. d e n t i a 1 


1 s 1 z e 0 1 t h e a p p 1 i -- 

s«, b u t D RI w a n 1 0 d i t,, 


CANEXT is 

CA.NEXT is 

the I i st 
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(unu 

SE?d ) 



Set 

i t t h e a p p 1 i c a 11 o n 

i s a d e s k a c c e s s o r y N 

w — 

Set 

That 

i t 11”! e a p p 1 i c: a t i o n 
i s , i t r li n •=:> u n d e r 

:i. s N 0 T a G E li a p p 1 i c: a t ion- 
D 0 B a n d d o e? s n t d o a n y A E S 


cal 1s» 

S e t :i. f n o n—6 EI i a p p 1 i c: a t i o n (s e e b i t 6) r e q u i r e s 
c o m rn a n d i i n e p a r a m e t e r s b e f o r & e x e c u 13. o n « 


C o r p .. C c::« n t i d e n t i a 1 


Atari 




e r t i c a I B1 a n k A u g u s t. 2 6 >, i 9 (B 5 4 7 

B e r i a I N u m b e r O06 738 


Vertical B1ank Interrupts 


T h i s s e c: t i o n d e s c r i b e s t h e 0 S ’ s V e r t i e a I B1 a n k I n 1 e r r u. p t 
(V BI > h a n d 1 e r e n t e r e d t h r o u. g h t h e V BI v e c t a r a t $ 7 0» 

T hi e V B I h a n d 1 e r i n c: r e m e n t s t h e 3 1 *f r a rn e c: o u n ter" t r c 1 o c k 

a n d t h e n c h e c k s f o r m u. t u a 1 e x c 1 u s i o n b y t e s t i n g ' v b 1 s e m « 
I. f v fo 1 s e m i s 1 e s s t h a n o r e q u. a 1 t o z e r o, n □ o t h e r V BI 
c q d e i s e x e c u t e d„ 01 h e r w i s e a 11 r e g i s t e r s a r e s a v e d o n 

t h & s t a c: k a n ci t h e 31 v b I a n k c o u nter" " v b c: I o c k i s i n c r e 
mented„ 

:i: f t h e s y b t e m i s c u r r e n t i y i n h i g h - r e s o I u. t i o n m o d e 

(SHIFTMD >=» 2) and a low.resolution moni tor is attached,, 

t h e r e s- o 1 u t i o n i s s e t t o d e f s h i 11 m d « (o r z e r o „ 1 f 

'detshiftmd is >= 2) « This test is necessary because 

s o m e 1 o w r e s o I u t i o n rn o n i t o r s rn a y J1 b u r n u p 3 3 w h e n d r i v e n b y 

t hi e S1 s h i g h ~ r e s o 1 u t i o n v i. d e o s i g n a 1 « 

T h e h a n d 1 e r c a 11 s t hi e c u. r s o r ••••• b 1 i n k r o u t i n e» 

11 c o 1 o r p t r i s n o n z e r c:« t h e n t h e 16 e o 1 o r p a i e 11 e s a r e 

I o a d e d 1 r o rn t h e 16 w o r ci s t h a t ' c c:> i o r p t r p o i n t s t o« 

' c o 1 a r p t!'" i. s t h e n z e r o e ci 

II c r e e n p t i s n o r'i z e r o,, t h e n t h e s c r e e n s p h y s i c a 1 b a s e 

a d d r e s ch. s e t t o ' s c r e e n p t « ' s c r e e n p t i s t h e n z e r o e d ,• 

T h e r e m a y b e a n y n u rn b e r o t 3 3 ci e t e r r e cl 11 V BI v e c: t o r s „ T h e s e 
a r e e x e c u t e ci .j u s t b e f o r e t h e V BI h a n ci 1 e r r e t u r n s. T h e 
v a r i a b 1 e n v b 1 s c o n t a i n s t h e c: u r r e n t n u m b e r o f ci e f e r r e d 
v e c t o r s 1 o t s „ v b 1 q u e u e ' p o i n t s t o a n a r r a y o f N V B L. 

p o i n t w r s I a 1 s t h a t i n t u r i "i p o i n t t o cl e t e r r e d V BI c o d e o r 

N Li L L ( i n t hi e c a s e o t a n e m p t y s 1 o t) s 


Atari Corp« 


Centidential 
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I vb I queue o I ...*• 



-i— > h an d I er „ „ -»— > h an d ler... 


T h e 0 8 i n i t :L a 1 i y a 1 i a c a t e s 8 V 81 s 1 o t s» T h e 1 1 r s t s 1 o t 

i s r e b e r v e d *f o r G^ Ei! li b V EAI e: o d e u T o a d d a n o t h e r d e t e r r 0 d 

El a n d I e r , p I a c: e a p o i n t e r i n a f r 0 e (N U L L.) si o t« I i t h 0 r os 

a r e n o m o r 0 f r e e s 1 o t s , t h e n a 11 o c ax t e a 1 at r g 0 r V BI a r r a y , 

c o p y t h e c u r r e n t v e c t o r s t o t h e n 0 w a r r a y < c 1 e a r 1 n g a n y 

n e wu n la s e d 0 n t r 1 0 s > a n d u p d a t e v b 1 q u 0 u 0 a n d n v b 1 s » 

D e t os r r e d V 8 !t h a n d 1 e r s s ri o u 1 d r e t u r n w i t h R I 8 , n g t R T E« 
T h 0 y rn a y u s e a n y r e g i s t e r s 0 x c 0 p t t ft os u s e r s t a c k - p o i n t e r « 

0 "i p p I i c: a t :i. o n s a r e r e s p o n s 1 b 1 © t o r c: 1 © a n i n q u p v b 1 - v e c t o r s 

t h 0 y h a v e :i n s t a 11 0 «j p r :i. o r t o p r o c: e s s 1 0 r rn :i n a 1 1 o n „ 


ri t a r 1 C o r p „ C o n t i d 0 n t i a 1 
















tern 
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4 Q 


R G M S y s t e m I n i t i a 1 1 z a 1 1 o n 


L 1 3 I n i t i a 1 P C s e t f r o m 1 o c: a t i 0 n # F C000x n x t i a 1 S P 
i t r a s h , r 0 a i 1 y) s 0 1 f r o m 1 o c a 1 1 o n F C O 0 

C a t c: h s y s 1 0 m R E S E.' T „ R a :i. s e p r o c 0 5 s o r I p L t o 7 „ 0 x e. 

c u 1 0 R E S E T x n s t r u c t i o n t o r 0 3 e t h a r cl w a r 0 r 0 g i s 1 0 r s.. 

I f a d x a eg n 0 s t i c c: a r 1 r i d g 0 i s i n s 0 r 1 0 d * 1 0 a d a r 0 1 u r n 
address into A6 and jump to the cartridge, 

Z 2 3 1 f n*i 0 m o r y w a s s 0 1 u p < i .. 0« t h i s x s a w a r m s t a r t) t h 0 

i n i t i a 1 x z 0 t hi 0 m 0 m o r y c a n t r o 11 0 r • 

i 3 3 I f t hi 0 R E. S E T — b a i 1 o u t v 0 c: 1 0 r x s v a 1 i d „ i o a d a r 0 1 u r n 

a d d r 0 s s x n 1 0 A 6 a n d j u rn p t o t h 0 r e s 0 1 h a n d 1 0 r . 

I" 4 3 I n x t x a 1 x z 0 t h 0 P S G < d 0 s 0 1 0 e t f I 0 p p x 0 s) , b e* t u p t h 0 

scan rate (50 or 60hz), write default values to the 
c 0 1 0 r p a 1 0 11 0 s h a n d s 0 1 t h 0 d x s p 1 a y p 0 i n 1 0 r 1 0 
Ox 10000« 

11 m 0 m o r y w a s s i z 0 d 0 n a p r 0 v x o u s r 0 s 0 1, g 0 1 0 s t b p 8 „ 

C 5 3 8 x z e b 0 1 l "i b a n k s o f m 0 m o r y „ 

[.' 6 3 L T h i s u s 0 d 1 0 p 0 r f 0 r rn a m 0 m 0 r y 1 0 s t« 3 

17 3 0n c: 0 m 0 rn o r y h a is h 0 0 n s x z 0 d a n d z 0 r o 0 d ,, r 0 c cd r d t h 0 

t a c:: t b y s 0 11 x n g t w 0 rn a g 1 c 1 0 n g w 0 r d s x n I 0 w n i e rri o r y« 

LSI Clear the low 64K of memory, from endosbss to 
0 x t f f : *t : „ I i"i x t x a 1 x z 0 a 1 j. k x n c :i s ex f 0 S v a r i a b 1 0 s „ 
S 0 1 u p x n 1 0 r r u p t v 0 «::: t cx r s» C a J. 1 t h 0 s 0 r 1 a 1 B10 S i n i 
t x a 1 :i. z a t i 0 n 0 n t r y - p 0 i n t« 

Z 9 3 Ex ecu1 0 XX2 c:ar t r x dg 0 app 1 x c at x ons« 

J. n i t x a 1 x z 0 t h 0 s c r 0 0 n r 0 s o 1 u t x 0 n „ 

C 11 3 E x 0 c: u t e X X 0 c a r - 1 r x d g 0 a p p 1 x e a t x o n s« 

I” 12 3 Enab 1 0 x n t er r up t s < a 11 but HBLANK) by br i ng i ng t h 0 
IPL to 3. 

[.' 1 3 3 E x 0 c u 1 0 X X1 c a r t r x d g 0 a p p J. i c a t i c:» n s« 


A t a r i C o r p>« C 0 n f x d 0 n t i a 1 





1 0 m S t a r t u p A u q u s t 2 6 „ i 9 8 5 
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1114 2 Ca 11 BEHDGS i n i t i a I i z at i on r out i n 0 

C 153 Attempt to boot from -floppy disk, it the system 
v a r* 1 a b 1 0 b o o t d 0 v i s l 0 s s t h a n 2 * 11 t h e r 0 a r 0 n o 

11 o p p i 0 s , n a a 11 0 m p t 1 s m a d e t a b o o t f r o m 11 o p p y„ 

A 11 0 m p t t o 1 o a d a b o o t s 0 c t o r f r o m t h 0 D M A b u sF 7 o r 
0 a c h o t t h 0 0 i g h t D l v 1 A b u s d 0 v i c: 0 s a r 0 a d o p 0 r a t i a n 
1 s a 11 0mp 1 0 d on 1 o q i c. a 1 s0 c t or 0 « 11 1 h 0 r 0a d i s 

s u c c 0 s s f u i , a r1 d t h 0 s 0 c t o r c: h 0 c: k s u m s t o $ 1234 «, t h 0 n 
t h 0 s 0 c t o r i s 0 x 0 c u 1 0 c:i „ [.' S 0 0 t h 0 s 0 c; t i o n 1 f D ii A B u s 

Boot n J 

A L L. d 0 v i c. 0 s a r 0 c h 0 c F: 0 d „ T I"! 0 b o o t s 0 c t o r c cj d 0 m a y 
r 0 1 u r n , i n w h i c h c a s 0 t h & B 10 8 w i 1 1 a 11 0 m p t t o 1 o a d 
b o o t s 0 c t o r s t r o m t h 0 r 0 s t o f t h 0 d 0 v i c: 0 s 

116 J T u r n cj n t h 0 c u r s o r D o a u t o 0 x 0 c „ A 11 0 m p t t o 0 x 0 c 

COMMAND.. PR 8 . 

C J. 7 J D o a u. t o 0 x 0 c » !< I u. d g 0 u p a n ev n v 1 r cj m 0 n t s t r i n g « E x 0 c 

t h 0 A E 8 i n l 7 i □ M ) « 

11 [.' 1 6 J a r l 1 71 ! 0 v 0 r c: c::» m p i 0 1 0 , t r e s t a r t t h 0 s y s 1 0 m h y 

g o 1 n q b ac k t cj L 1 2 « 


A t a r i C o r p «. C o n t i d 0 n t i a 1 
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System 
RESE T 


V 

I Diagnostic i (I) 

I C a r t r i d g e c h e c: k 1 

5 

I 

V 

! i v Iemory Contro11 er I (2) 

1 (fast init) i 

! 

y 

I RESET bailout I (3) 

! vector ! 

i 

V 

I init PSG \ (4) 

I i n 11 5 0 h z / 6 0 h z I 

I init palettes ! 

! d i s p 1 a y a t 1 0000 i 


i 

V 


YES 


I* -i a s m e m o r y b e e n 
s i z e d ? L i s t h i s 

a w a r m s t a r t ? J 


NO i 

* 

i 

V 

! size memory 1 

I and clear it 1 


I indicat & successfuJ. 1 (7) 

I warmstart ! 


A t a r i C o r p « C o n f i d e n t i a 1 



















S y s te m S t a r t u p 


A u g u s t 2 6 , 19 8 5 
S e r i a 1 N u m b e r 00 6 7 3 3 


V 

I C1 0 a r b o 11 o si'. 6 4 K ! (8) 

! 1 n i t v a r i a b 1 e s I 

! 1 n i t i n t e r r u p t s i 

\ 1 n i t s e r i a 1 610 8 1 


I E x e c: u t e % % 2 c: a r t r idge I (9 > 
I applications I 


I I n i t s c r e e n i ( i 0 > 

i resolution i 


V 

1 E x 0 c u t e % % 0 c a r t r :i. cl g e i (1 :l; 
I applications I 

i 

t 

V 

! Bring IPL to 3 I <12) 

| j 


1 E x e c u t e 7« % 1 c: a r t r i d g e I ( i 3 > 
I appiications ! 


! I n i t i a 1 i z e GEM Du 8 ! «; 1 4) 


••I- 


I Attempt to boot I >-\ 

! -f r orn t i op p y I < - \ i 

» :■ j 

t i i 


A t a r i C o r p „ C cj n f i d e n t i a i 


execute 

boot 

sector 

























3 y s t e m S t a r t u p 


A u. g u s t 26 , 19 3 5 
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V 

! F l a 1 1 0 v i c e s o n I 

! D M A b li s , r e q u e s t i n g I 
I boot sectors ! 

j 

V 


.1. w* a) 


\ 


execute 

boot 

sector 


.cmdload r “ 0 ? 


NO ! 

V 

! Turn on cursor i (16) 

1 E! x e c \ A U T 0 \ &« P R G I 

I El x e c: C 0 M M A N D«F :: ' R 6 1 


3 1 

I 4 

i i 

V i 

I Exec: \AUTO\*.PRB ! (17) ! 

1 K1 u d cj e la p e n v x r „ ! 1 

! string j I 

1 Exec AES (in ROM) I j 

l i 

i S 


V 

R e s e t s y s t e m 
s t a r t o v e r a g a i n 


Atari Corp 


Cantidentiai 












Boot Sectors 


A u g u b t 2 6 h 1 V 8 5 
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54 


B o a t S e c t o r s 


T h e b o t s e c t o r c o n t a i n s 

o A v o i u m e s e r i a 1 n u rn b e r 

o A B10 S p a r a rn e t e r b i a c k 

o 0 p t i o n a I b o o t c o cl e a n d b o o t p a r a m e t e r s 


An executable boot sector must word-checksum to the magic 

n u rn b e r $ 1234« D u r i n q s y s t e m i n i t i a 1 i z a t i o n t h e b o o t s e c. 

t o r *f r o rn a d i s k d r i v e i s 1 o a d e d i n t o a h u 11 e r . 1f t h e 

c l"i e c k s u. rn i s c o r r e c t, t h e s y s t e m J 8 R s t h e t i r* s t b y t e o f 
thie buf ter„ I'Si nce the I ocatx on of the but t er i s 
i n d e t e r rn i n a n t, a n y c o d e c: o n t a i n e d i n t h e b o o t s e c: t o r m u s t 
I::) e p o s i t i a n •• • i n cl e p e n d e n t „ 2 8 e e t h e s e c t i o n o n s y s t e rn i n i - 
t i a 1 i z a t i o n t o r t u r t hi e r d e t a i J. s o n w r i 1 1 n g h o o t a b i e 
app 1 x cat x ons« 

W h e n a * 5 8 e t B P B 8 5 c a 11 x s rn a d e H t h & B10 S r e a d s t h e h o o t 

s e c: t o r a n d e a rn i n e s t h e p r c:» t o t y p e B10 S p a r a m e t e r b 1 o c k 
(B P B > « A B P B x s c c::« n s t r u c t e d t r o m t hi e p r o t o t y p e.. 1 f t h e 

p> r o t o t y p e 1 o a k s s t r a n g e (*f o r i n s t a n c e, x f c r i t x c: a i f i. e 1 d s 

x n x t a r e z e r o > t h e B10 S r e t u r n s N U L L (a s a n e r r o r x n cl x. 

cat x on >» 

A B P B x s n c::« r rn a J. 1 y c o rn p u t e d a n d w r i 11 e n w h e n t h e v a 1 u rn & x ci 

formatted.. 

T hi e 2 4 - b i t s e r x a 1 n u rn hi e r x s u. s e d t o d e t e r rn x n e 3. f : t h e u s e r 
h a s c h a n g e d d x ;h> k s« (s e e t h e l s t i 11 n ex n e x i s. t a n 1 2 s e c 13. o n 

o n !! D x s k C hi a n g e s “ ) „ T h e s e r x a I n u rn b e r x s c o m p u t: e d a n d 
wr x 11en by the FORMAT ut x 1 i ty „ and i s (hopef u.l i y ) un x que» 


ntarx Corp„ 


Cent i cienti ai 





Boot 


Sectors 
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BRA« S 
(wherever) 

•f i i 1 er 

(OEM 
c r u f t) 


•4- 


$0 


*2 


BEE1hL 

2 4—b i t v a i u rn e 
s e r i a i n u m b e r 

BPB 




-4* 

! $b 


4-. 

i I 
ih 

4- 


i 1 
I h 

4. 

! 1 
; h 


! 1 
I h 

4 .- 

! i 

! h 

i 1 
1 h 

5 1 
i h 

4- 


SPG 

RES 

MEATS 
NO IRS 

NSECTS 

1EDIA 
SPF 

SET 

NSIDES 

NH ID 


boot code 
(if any) 




td 

:$• 10 
$ 1 1 

*13 


1 * 15 

-4- 

i $ 16 

i 

i 

! *18 


—1~ 


'■$ 1 a 


'$ 1 < 


1 e 


4- 


#2<X 


A t a r i C o r p « C o n f i d e n 1 1 a 1 


b r a n c h t o b o o t c o d 

r e s e r v e d f o r 0 E li s 


v o 1 u rn e s e r i a 1 n u m b e r 
w r i 11 e n b y F* 0 R M A T 

# b y t e s / s e c t o r 

# s e c t o r s / c i u s t e r 

# r e s e r v e d s e c t o r s 

# FAT's 

# d i r e c : t o r y e-? n t r i e s 

#sectors on med i a 

rn e d i a d e s c r i p t o r 

# s e c t o r s / F A T 

# s e c t o r s /1 r a c F: 

#sides on media 

# h i d d e rs s e c i: o‘r 
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T h e p r o t □ t y p © B P B i s s o f t w a r e c: o m p a t i b 1 e w i t h a n li 8.D 0 S 

v © r s i o n 2. x B P 8. ( T h i s d o e s n o t m e a n t h © 8 T c a n r e a d 

s © c t o r s w r i 11 e n b y , o r w r i t e s e c t o r s r © a d a b 1 e b y , a d i s k 
c o n t r o 1 1 © r o t h © r t h a n t h e W D C i 770 / 1772 > . 

The low byte of a 16-bit field in the BPB (such as BPS') 
a c c u p i e s t h e 1 o w e r a d d r © s s C a s o n t h e 8086. 3 

B P S i s t h e n u rn b © r o f h y t e s p e r s e c: t o r (f o r f 1 o p p i © s o n 

t h e 8 T , i t w i 11 b e 512) „ 

S P C 1 s th © n u mb e r of s ©c t or s p © r c 1 us t e r (o n f 1 op p i e s , 

u s u a 11 y 2 f o r a c: 1 u s t e r s i z e o f 1K) . 

R E S i s t h © n u. m b © r o f r © s e* r v e d s & c t o r s a t t h © b © q i n n 1 n g o i 
the rnedia, inc 1 udirig the boot sector. RES is usual 1 y 1 
on f1 oppies» 

N F A T S i s 1h © n u m b © r o f F i 1 e A11 o c a t i o n T a b 1 e s o n t h e 

m©d :i. a 

N DIR S i s t h © n u m b © r o f d i r © c: t o r y © n t r i e s.. 

N 8 E C T 8 i s t h e t o t a 1 n u rn b e r o f s e c t o r s o n t h e rn © d i a 
(i n c J. u d i n g t h e r © s © r v e d s e c t o r s) - 

MEDIA is a media descriptor byte. The ST BIOS does not 
u s © t h i s b y t e «, b u t o t h © r f i 1 e - s y s t e rn s rn i g h t,, 

8 P F i s t h e n u m fo © r o t s e c t o r s i n © a c h F A T«, 

S P 7 i s t h © n u rn b e r o f s e c t o r s p e^ r t r a c k „ 

N 81D E S i s t h © n u m b © r o t s> i. d e s o rt t h e m e d i a« (S i n g 1 e— 

s i d © d rn © d i a c a n b © r © a d o n d o u b 1 e - s i d © d d r i v e s , b li t n o t 

v i. c e—v © r s a > « 

N H 10 i s t h © n u m b © r o f 1! h i d d © n f J s © c t o r « (T h e S T B10 S 

c li r r e n 11 y i g n o r © s t h i s v a 1 u © fa r f 1 a p p i e s ) .. 

T h e 1 a s t w o r d i n t h © b o o t s © c t o r (a t o f f s © t $ 1F E') i s 
reserved for “evening out n checksums. In particular„ the 
11 p r o t o b p b 1 ‘ © x t © n d © d B10 S i u n c t i o n m o d i f i © s t h i s w o r d« 


A t a r i C o r p . C o n f i d © n 1 1 a 1 
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F o r rn a 11 i n g a F I a p p y 


C 1 IJ U s e t h e ’ t 1 o p f rn t () ( # 10 « ) e h t e n d 0 d B 10 8 e a 11 t o t o r 

m a t a 11 t r a c k s o n t h 0 t 1 0 p p y d i 0 k « 11 t r a c: k s 0 o r i 

h a v e a n y b a d s 0 c t o r s t h 0 n t h 0 m 0 d i a 10 u n u s a h 1 0 „ 

T h 0 S T s t a n d a r d t o r m a t i s 

1 or 2 sides; 

80 tracks; 

9 s 0 c t o r s p 0 r fc r a c k ; 

n o i n 1 0 r X 0 a v 0 (s 0 q u. e n t i a 1 s 0 c t o r s) » 

Zero the first two tracks (this will zero the FAT and 
d i r 0 c 1 0 r y s 0 c 1 0 r s > « 

C 2 .1 U s e t h 0 p r 0 1 0 b t () ' (# :l. 8 « ) 0 x 1 0 n d 0 d B 10 S c a 1 i 1 0 

e r 0 a t e a b o 0 1 s 0 c: 1 0 r « T h 0 d i s k t y p e p a r a m 0 1 0 r 
s hi o li i d b 0 2 0 r 3 t 0 r 1 0 r 2 s i d 0 d 8 0 -1 r a c k m 0 d i a 

r 0 s p 0 c t i v 0 X y u T h e ' s 0 r i a 1 n o ' p a r a m 0 1 e r s h o u I d b 0 a 
r a n d 0 rn n u m h 0 r (0 r $ i 000000 > „ 


The 

ex 0c 

•f 1 a 

g 

P 

ar 

•aniE 

‘ter 

shou.X d be 

zero uni 

ess 

t h 0 

prot 

otypi 

n g 

b 

Lit 

t er 

cor 

tai ns 

code 

K S LI c h i a Ei 

a 

cop 

y ot 

the 

Loader > 

th 

.at 

V 

# O u 

war 

it exec 

Li t ed 

when the 


disk 

i s 

boot 

ed« 













Wr i t 

0 t hi 0 

bo 

ot 

E 

ec: 

t or 

H ( 

protot 

yped 

i n t hi 0 

:> Lit t er 

i n 

step 

c 2 ::i 

) 

t c: 


t r 

ac h 

c 

, side 

0 , s 

ector 1 

ot 

the 

■ new 

di sk 

Do 

NO 

T 

US 

p.’i 

t hi 0 

r ' r 

wabs 

cal X ; 

use the 


0 x t e 

nded 

B X OS 

tunc 

1 10 

n 

t 

1 c: 

jpwr 

« 







p 0 

ssi h X 

e t 

0 

cr 

0 d 

it 0 

d i s 

; k s i n 

wi erd 

tor mats;. 

b 

y 

ary- 


1 n g t h e n u. rn b 0 r o t s 0 c 1 0 r s p 0 r t r a c k , t0 r rn a 11 i n g a f 0 w 

0 x t r a t r a c k s , 0 r s p 0 c: 1 1 y i n g s t r a n g 0 i n t r 1 0 a v 0 -f* a c i: o r n-- „ 

T h 0 1 772 5 f w r i 1 0 t r a c: k ‘ 1 c: cd d 0 s u s 0 d 1 0 f 0 r m a t a t r a c: k a r 0 s 

C 0 U N T B V T E! w h a t 

6 0 4 0 (s t a r t 0 f t r a c k ) 

F o r 0 a c h s 0 c: t o r : 

12 T "00 

•5 15 (w r i 1 0 s :i|i : a 1 ) 


Atar :i. Carp « 


Cant :i. dent i a I 





Floppy 


Formatting 


August 26„ 
E> 0 r i a. 1 N u m b e r 


1985 

006738 


1 

$f 0 

< ID a d d r e s s m a r k ) 

1 

track# 

< 0«.$4f) 

1 

si do# 

(0.. „ 1) 

•j 

sector# 

(1. „ 9) 

1 

$02 

(512 h y t o s / s e c t o r ) 

1 

$f 7 

< 2 C R C s i\i r i 11 e n) 

2 2! 

$4e 


12 

$00 


3 

$f 5 

(Nr :i. tes $ai ) 

1 

$f b 

(d a t a a d ci r e s s rn a r k ) 

5:!. 2 


i virqin data) 

1 

40 

$f 7 
$4e 

< 2 C R C s w r i 11 e n) 

End of 

trac k r. 


1401 

$4e 

\ f i J. 1 er at end of f 


A t a r i C o r p « C o n t :i. d e n t i a 1 
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DMA Bus Boot Code 


! hi i s c o d 0 , 0 x t r a c t e d f r o m t h e 81 s B10 S * a 11 e m p t s t o I o a d 
b o o t :!:•• e* c t o r s 1 1 '" □ m d e v 1 c 0 s □ n t h e D M A b u. s- „ T b e c: o d 0 c a n 
be useds 


q A s a n 0 x a m p I 0 o t h o w t o la s 0 t h 0 D M A b u s <u. s e? f u I 
f o r b o 0 t — s 0 c t o r a n d d 0 v i c 0—d r i v 0 r w r i 10 r s) 5 

q j" d p r o v :i. d 0 i n 10 r m a t x on ab o u t t h 0 t i m 00u t a n d 
c: 0 rn m a n d c h a r a c: 10 r i s t i c s 0 x p 0 c 10 d f r 0 m b 0 o t a b 10 
D M A b u s d 0 v 1 c: 0 sr. 


gpx p 

eg u. 

#ff f f f aOi 


(B > 

68901 i n p u t r 0 g i s 10 r 

d i s k c t ]. 

eg u. 

;:j:; .f 0 0» ) .4}. 


<W> 

d x s 

< c 0 n t r 01 ]. 0 r d a t a a c c 0 s s 

•f : i c:> 

egu 

t f f 8608 

»! 

( W ) 

DMA 

mode control 

dmahigh 

equ 

■|:-f -f f f 8609 


(B) 

DMA 

base high 

dmami d 

egu 

f f f 860 b 


(B) 

DMA 

base rnedxum 

clmal ow 

egu 

f f f 860 d 

*1 

(B) 

DMA 

base low 

•f : 1 oc k 

egu 

•J ; 43 e 


( W ) 

DMA 

c h x p 1 0 c k v a r x at b 1 0 

dskbu-f p 

equ 

it 4 c 6 

jj 

(L) 

> 

IK disk buffer 

hi z _200 

egu 

::t 4 ba 

4 

<L> 

2001 

*!z c ola nter 

ft-!- 

•ft drnaboot •• 

- attempt 

to boot from 

a device? 

on 

t h 0 

DMA bus. 


* P a s s 0 d s n 0 1 h i n g 

* 

* R 0 1 u r n s s m a y b 0 ••••• n 0 v 0 r (a 11 h 0 u g h x t d 0 p 0 n d s « « „ ) 

•ft 

* U s 0 s n 0 v 0 r y t h :i. n g 

* Di sc:us01 on s 

* 11 0 rn p t s 1 0 r 0 a d b 0 0 1 s 0 c 1 0 r s 1 - r 0 m 01 g h t d e v 1 c 0 s c: c:) n n 0 c: 1 0 d 

•x- t c:« t hi 0 30 M A b ix s« I f a s 0 c t o r s r 0 a d ? a n d 1 1 1 ss e x 0 c u t. a b I 0 

* (w 0 r d c h 0 c: k s u. rn 1 s :i|i ; 1234 ) , t h 0 n i t 1 s 0 x 0 c u 1 0 d . 

•:ft 

* i h i s c o d 0 s r*i o u i d t a 0 a b 0 la t 0 ,, 5 s 0 e 1 0 0 x: 0 c la 1 0 i f n 0 1 h i n q 

is connected to the DMA bus,, Of course, it something IS 

* h 0 o k 0 d u p x t s h 0 u I d p r a v i cl 0 u s w 1 1 h a b 0 o t s 0 c 1 0 r „ r i g h t ? 

•ft- 

¥. 

drnaboot s 

rn 0 v 0 q # O , d 7 n s t a r t w 1 1 h d 0 v # O 


A t a r i C o r p . C o n f i d 0 n t i a 1 









Bus Boot 
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60 
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dmb.1 ii 

bsr 

d fn a r e a d 

H 

a 11 e m p t t o r e a d b o o t s e c t o r 


bne 

dmb.2 

H 

(t a i i e d . t r y n e x t d e v) 


move „ i 

dskbutp ,{aO 

•1 

a 0 > d i s k b u t f e r 


move,, w 

#$•00+ f , d 1 


c h e c k s u m $ i 00 w o r d s 


moveq 

#0 , t dO 

!$ 

checksum = 0 

dmb 3 s 

add„ w 

< aO ) + <i dO 


a d c j ( n e x t) w o r d 


d b r a 

d 1 ,, dmb.3 




crop« w 

# b o o t m a q :i c , d 0 

;i 

i s t h e s e c t o r e x e c u t a b i e ? 


bne 

dmb.2 


(nope) 


move,, 1 

dskbutp h aO 

n 

a 0 - > d i s k b u f t e r 


j sr 

( aO ) 



dmb 2 n 

add „ b 

#$ 20„d / 

i 

next devno 


b n e 

dmb_ 1 

H 

C ci o a 11 e :i q h t d e v s ) 


r t S 










d rn a r e a d a 11 e m p t t o r e a d b o o t 

s e c t o r i ; r o m D M A b u s d e v i c e 


Passeds 

d 7 »lr.) r - :: d d d 00000 


¥: 

«:• 


( ddd is the ACSI 

d e v i c e n u. m b e r H 0 „ 7 ) 

Returnss 

NEs read failed; 


•¥< 


E Q s s u c c e s ?"• f t.i 1 r e a d , 

* 


s e c: t o r d a t ax i n 

< * _ d s k b u t p ) Z J 


Preserves: 

d 7 « w 






•:«r 

Uses r, 

e v e r y t h i n q e 1 s e 


•jRr. 

dmaread i: 




1 ea 

tito,a6 h 

a 6 > D M A c o n t r o i r e q i s t e r 


1 ea 

d i skct 1 , 5 a 5 ;; 

ax 5 -• > D ii A d a t a r " e q x s t e r 


s* t 

t i ock 

i o c k u p D i i A ax g a x n s t v b 1 ai n k 


move,, 1 

d s k h u. t p 5 ( s p ) ; 

s e t la p D Ii Pi p o i n t e r 


move„b 

3 (sp? ) ,»dmaxl ow 



move„b 

2(sp ) „dmamid 



move « b 

1 (sp) dmahigh 



ad dq 

#4 ? sp? 



move,, w 

#$ 098 ,(a 6 ) 5 

t cj g q 1 e F< / W, 1 e a v e i n R e a d s t 


move» w 

# 198 n ( a 6 ) 



moveu w 

#$'098 , t (a6) 



move„w 

#1 , t ( a 5 ) 5 

w r i t e s e c t o r c o u. n t r e q i s t e r 


move« w 

#$ 083 ,(a 6 ) 5 

s e 1 e c t d m a b la s < n o t 8 C R ) 


move,, b 

d 7 n d 0 r, 

s e t u p? d 0 „ L w i t h d e v n o c o m rn a n 


or » b 

#$ 08 , dO ;; 

d 0 « b d e v n o < < 5 « 0 R „ E 5 R E A D s 1 


swap? 

d 0 



move«w 

#$ 088 „dO 



C o r p,. C o n t i d e n t :i. a 1 


I" !™i 

= 1) 

ommand b 


Atari 















Dlif 

3 Bus 

Boot 
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to S r 

wcbyte 


fi 

d0 „ i.... = x x x x x x x x ODD01 000k x k x x x x 0 i 000 1010 


tone 

dmr.q 


h 

(p u n t o n t i m e o u t) 


iiioveq 

#3 n d6 


n 

(count = 4) 


move. 1 

#$0000< 

308a,dO 

? 

d 0. L = g e n e r i c c o m m a n d < $0000) 

dmr 

.i p s tosr 

wcbyte 


u 

w r i t e to y t e s 2 n 3 4 a n cl 5 


to n e 

dmr q 


5 

(p u n t cj n t i m e o u t) 


dbr a 

d6„dmr 

I p 

j! 

(1 o o p t o r m o r e to y t e s) 


move. 1 

#:$:0000 s - 

jUUa,(a to ) 


w r x t e to y t e 6 (f x n a 1 b y t e) 


move„ w 

#400 H d: 

1 

; 

t x m e o u t - 2 „ 0 s e c 


bsr 

wwax t 


»t 

w a i t f o r c o m p 1 e t i o n 


to n e 

dmr q 


u 

p u. n t o n t x rn e o u t) 


move« w 

#'i ; 0Sa, 

< a 6) 

,1 

s e I e c t s t a t u s r e g 


move „ w 

i a5) , ci i 


* 

q e t r e t u r n c o cl e t r o rn 13 M A d e v i c: e 


and „ w 

#$UUtt 

H dO 

fl 

s t r i p c r u 1 1 y to x t s 


toeq 

dmr.r 


jt 

(return it OK) 

— 

reset DMA, 

return 

NE 



dmr 

.q s 






moveq 

# -• 1 ,, dO 


n 

r e t u r n i (e r r o r ) 

dmr 

.r s move.w 

#$080, 

(a 6) 

5 

c 1 e a n u p D M A c hi i p t o r -f 1 o p p y d r x v e r 


tost » to 

d 0 


? 

( t e s t f c:? r 14 E o n r e t u r n ) 


s-f 

•f 1 oc: k 


Jl 

u n 1 o c: k 01 i A c h x p 


rts 



? 

return 







WC 

toyte . wri* 

t e A C SI c 0 m m a n ci to y 

te, wait tor 

IEQ 

* 

Passeds 

D 0 „ L c 0 m m a n d to y 

te and FIFO 

cantorol 



b X to S 1 n u 

23 «= command 

toyte h 



tox ts On« 7 

= FIFO cent 

r o 1 to i t s 



a 5 .> $ f f 8604 









Returnss 

M E 0 n t a x 1 u r e (t x m e o u t) 


*:• 


E Q o n si- u c: c e s t u 1 

ACK 



j | «« 

ri i 





•••« *»• 



;&. 

wc toy t 

.0 S 





move. i. 

d0.» (a 5 ) 5 

wri te 14 DC 

14 D L. L d u e t o j w t 3 


moveq 

# 10 ^ d 1 ;; 

wait 1/20th 

second 

wwax t 

2 acid. I 

hz _200 , cl 1 5 

d1 = time t 

o quit at... 

ww.1 

totst „to 

# 5 ,gpip 5 

disk done? 



toeq 

ww_w r, 

(yes h retur 

n) 


cmp. J. 

hz 200 ? d1 n 

tx meout? 



to n e 

WW .1 H 

(not yet . - 

w a x t s o m e m o r e « » „ 


moveq 

#-i,dl 

ensure NE ( 

t x rn e o u t e r r o r ) r e t 
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ww w 

















Partitions 
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H a r d D i s k P a r t i t. i a n i n g 


T h e f i r s t s e c:: t o r (1 o q i c a 1 s e c: t o r # 0) o n a h a r d d i s k c o n. 

t a i. n s p a r t i t :i. o n i n t o r m a t i o n « 


off set 


hd S3. Z 

i *lc2 

a 

put 1 g 

! '$• i c <b 

pO. i d 

\ $lc7 

pG_st 

i i o a 

pO si z 

i 

i -i- i c s 

I 

p 1.f i q 

i *ld2 

p 1 _ i d 

i 4? Id3 

p 1 _st 

1 *ld6 

p 1 SI z 

! 

1 4? Ida 


p2_t1q 

! fide 

p2. i d 

i $ldf 

p 2.st 

1 $le2 

i 

p2_siz 

i 

! 4? .1 e6 

1 

$ 

p3.f I g 

« $:l.ea 

p3_i d 

! #leb 

p3.st 

1 $ 1 00 

p3_si z 

i 

i 4? i t2 

bsi _st 

! $ 1 f 6 

bsi cut 

i 

I $ i t a 


s i r e s e r v e d ) I :$• 2 0 0 


A t a r x C o r p » C o n f i d e rs t :i. a .1 
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h d s i z i ns t h e t o t a I s :i. z e o f t h e d i s k ? i n I o g i c a I s e c - 

tors., 

b ns I s t ns p e c i f i e s t h e ns1 a r t i n g ns e c t o r # o t t h e b a d s e c: t o r 
1 inst, l! ypical 1y the bad sector 1ist Hi 11 be Xocated at 
t h e e n o o f t h e d 0 v i c: e „ 11 

b s I c n t s p 0 c 3. f i e s t h e / n u m b e r / o f h a d s e c t o r s.. E a c h 
h a d s e c: t o r i s ns p e c i t i e d b y a 1 o n g w o r d c o n t a i n i n g t h e 
ns e c t o r s n u m b e r « T h 0 t o t a i n u m b 0 r o f s 0 c: t o r s u s 0 d u p b y 
the bad sector list is therefore bsl siz‘ / 4 . If 
b s 1.c n t i s z 0 r o t h 0 r 0 a r 0 n o b a d s 0 c t o r s. 

A d i s k m a y c o n t a i n u p t c:j f o u r p a r t i t i o n s« T h 0 f i r s t ns 0 c 
t o r i n a p a r t i t i o n i s a b o o t s 0 c t o r (w h i c h , 5 o n t h e S T «, 
w i 11 c o n t a i n a B P B) . 


I root boot 1 


I partition 0 l 

i « 

I partition 1 ! 

1 (optional) ! 

I partition 2 i 

I (optional) i 

I partition 3 I 

I (optional) I 

I optional I 

> bad sector 1 

I 1 i ns t l 


E a c h p a r 1 1 1 1 o n i. s d 0 s c: r i f.::« 0 d b y a 12 - b y 1 0 s t r u c t u r 0 i 


P*.t i Q 


I < 4-0 ) 


Atari Corp, 


Conf 1 dentiaI 
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I p*.id ! ( + 1) 



! p*.si z I (4-8) 


\ 12» } 

f i g s h o u 1 d h e n o n z e r o t o i n d i c a t e t h a t t h e p a r t i t :i o n 

l s« T h e B 10 8 w :i. 11 i::) o o t t f“i e -f :i. r s t p a r t i t i d n t h a t h a s 

7 s e t i n t h :t s b y t e. 

_ i d i s a t h r e e - b y t e f :i. e 1 d 

1 i o n « F □ r 8 IE M D 0 8 p a r t i t i o n s ^ 

a s c i i c h a r a c: t e r s 11 8 SE M 21 „ 

p * . r:i:. t s p e c 1 11 & s t h 0 1 o g 1 c a I s e c t o r n u rn i::> e r c* f' t f i 0 b 0 q i n •••• 

si i {• *1 g o f t h 0 p a r t i t i o n * 

p * s 3. z s p 0 c i t i 0 s t h e s i z a f t h 0 p a r t i t i 0 n ,, i n i 0 g i c a i 

sectors,. 


t. h a t i d e n 1 1 1 i 0 s t h 0 p a r t i — 
11") 0 f i e 1 d c o n t a i n t h e t h r e e 


e; *: :i. 
b i t 


Atari Corp 


ContidentiaI 











Boot Loader 


A u g u s t 2 6 „ 19 8 5 

S e r i a j. U u m b e r 0 0 6 7 3 8 


The Loader 


T h e L o a d e r i s a g e n e r i c s y s t e rn — I o a d e r * 1t 1 i v e o n b o o 1 
s e c t o r s , a n d i s b r o u g h t i n t o R A l v i a n d e x e c u. t e d d u r i n g s y s — 
t e m i n 1 1 i a I i z a t i o n „ T h e L o a d e r h a s t h e c a p a b i 1 i t y t o 
I o a d a n 51 i m a ge“ f i i e o r a s e t a f c a n t i g u. o u s s e c t o r s f r o m 
di sk« 

I h e s i x r e s e r v e d b y t e s s t a r t i n g a t q t f s e t 2 i n t h e b o o t 
s e c t o r m u s t b e 2 


Loader 

•f o r ib o m e t o a I s t o b e a b 1 e t o rn a n i p u 1 a t e L.. C3 a d e r b o o t s e c - 
tors- 

A n 1 rn a g e t i 1 e c o n t ax 3 . n s n o h e a d e r o r r e i o c a t i o n :i. n f o r rn a 

t i o i“'i« 11 1 s a n e x a c t :i. rn a g e o t t i n e p r o g r a rn t o b e e x e. 

c u 1: e d .. T' h e I o a d e r i r-> c:: a p a b I e o t I o a d i n g a n y f : 3. 1 e f r o m 
cd 1 s k , r e g r d 1 e s s o f w h e r e i t a p p e a r s i i ”i t h e d :l e c t o r y o r 
w h e t h e r t h e f i i. e i s c o n t i g n o u s o r n o t« 

L o a d e r i n f o r rn a t i o n i m m e d i a t e 1 y f o 1 1 o s t h e B P B :t n t h e 

boot sectors 




EXECFLG 


LDMGDE 


SSEC 1 


SECTCNT 


LI) A DDR 


Ph iBUR 




1 e 

.erndl oad 

$20 

load mode 

s e c t o r Hii t ax r t 
$24 

#sectors 

*$ ..-j*. 

1 o ai d • a d c j r e s s 


$ 2 a 

FAT address 


A t a r i C o r p „ C cd n t i d e n 1 1 a I 
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66 


FNAME 


n 

n 

n 

n 

n 

n 

n 

n 


0 

e 


::|i ; 20 


i (re s 0 r v e cl; ! $ 3 9 

BOOTH i :l : 3 a 

1 code ! 


E! X E C F L G i s a w a r d t h a t i s c o p i e d t o c. m d l a a d „ 

L D II 0 D E g o v e r n s t h e 1 o a d i n g m o d e« 1 1 L D M 0 D E i s z e r o a 

f i I 0 i s s 0 a r c h e ci t o r a n d 1 o a d e ci» I f L D11 0 D & i s n o n z e r o ,, 
then SECTCNT" sectors, starting with 1ogical sector 
n u m b e r " S 8 IE C T , a r e 1 o a ci e d f r a m t h e d i s k« 

8 S E C T i s t h e 1 o g i c a 1 s e c t o r n u m b e r t o s t a r t 1 o a d i n q t r o rn 
C v a JL i ci i f f L D 11 01) E i s n o n z e r cd ) . 

S E C T C N T :L s t h e n u rn to e r o t s e c t o r s t c:« 1 o a d (v a 1 i d i t f 

L. D II 0 D E :l. s n o n z e r o) » 

1 ... JO A D D R 1 s t h e ! o a d ~ a cl d r ess o t : t h e f i 1 e C c:* r t h e s e c: t o r s) „ 

F A T B U F p o i n t s t o a p 1 a c: e t o p u t t h e F A T a n d ci i r e c: t o r y 

sec: t or s „ 

F N A 11 EJ i s a t i 1 e n a rn e t o 1 o a d < v a 1 i ci 11 f L D l v l 0 D E i s- z e r o > „ 
11 c: o n s i s t s o f e i g h t c: h a r a c t e r" n a m e a n d a t h r e e c h a r a c t e r 
ex ten si on 

IJJ 8 e 0 a 1 s o s c:i o c: u rn e n t a t :i. o n o n t h e B 0 0 T G E N u t i 1 i t y« JJI 


At ar i Cor p « 


Confidential 








S o t t S y s t e m A u g u s 1 2 6 , i 9 8 5 

S e r i a 1 N u m b e r 0 0 6 7 3 8 


B o o t 8 e q u e n c e? 


[. 1 3 The boot 

s e c t o r i s I o a d e (3 « T h e 

L o a d e r t a k e s c 

on . 

trol at t 

he system.. 




123 The boot 

devi ce s d:i. 

rectory and 

2 n d F A T b u t -f e r 

ar e 

read i ntc: 

? memory, st 

arting at 

m e rn b o t „ T h e L o a 

der 

searches 

tor a tile 

(usual 1y ) e 

al1ed TOS.IMG. 

It 

i t i n:> n c 
DO „ 

)t tound , it 

red.;urns wi 

th an error code 

i n 

E3:i TOS„ IMG i 

s read into 

memory, st 

artinq at ^40000 


f ' 4 1 Control i 

s passed to 

the tirst 

byte of TOS.IMG. 



T G 8« IM G c: o n s i s t s o t t h r e e p a r t s s 

C 13 A r e 1 o c a t o r (R E L 0 C R L) t h a t m o v e s T □ 8« I M 8 t o w h e r e 

i t © x p e c:: t s t o b e e x e c u t e d i n m e rn o r y . R E L 0 C R L 

tak©s <:::ontro 1 of the systern , f ades the screen, 

p e r f d r rn s a t a s t b i o c: k -*• c o p y , a n d p a s s e s c o n t r o 1 t d 

t l"'i e f i r s t b y t e :i. n t h e a p« e r a t i n g s y s t e m« 

C 2 j A n i m a g e o f t h e o p e r a t i n g s y s t e rn ( ' p r o x 9 0 K) » 

C 3 3 A n i m a g e o f t h e d e s k t o p a n ci G E M < ' p r o x J. 10 K) « 

y s t e rn i n :i. t i a I i z a t i a n p r o c e e d s a s n o r rn a i (e x c:: e p t *f o i- 

c: i e a r i n g rn e m o r y) o n c e t h © 0 8 h a s c: o n t r o 1 » 


A t a r i C o r p« C o n 1 1 d e n t i a 1 



Das Boot 
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6d 


Boot ROM 


! hi e S T b o o t R 0 li (A K A ! * D a s B o o t 11 ) c a n t a i n s a s u to s e t o t t h e 
B10 S» T h e o n 1 y t u n c t i o n s a v a i 1 a b 1 s r e I a t e? t o r e a c:i i n g 
f1oppy disks. 

to y s t e m i n i t i a I i z a t i o n i s i c::i e n t i c a 1 t o t h e n o r m a 1 0 8 p r o - 
c: e d u r e „ H o w e v e r * t h e 1 o c a t i o n s a n d i n t e p r e t a t i o n s o f t h © 
s y s t © rn v a r i a b 1 e s rn a y h a v e c h a n g e d ,, S e? 0 t h 0 0 n d o f t h i s 
s 0 c 1 3. o n t o r a 1 i s t o f 1s s a f 0 15 s y s 1 0 m v a r i a b 1 0 s« 

The normal course of events iss 

T h 0 b o o t R 0 M c a t c:: !i e s R E S E 1 a n d i n i. t i a 1 1 z 0 s t h 0 

s y s 1 0 m« 1 1 p u t s u p:* s o rn e p r 0 11 y g r a p h i c:: s» 

Ki ds 1 ]. 1 ove 1 1 « 

A n a 11 0 rn p t i s m a d 0 t o b o o t t r o m h o t h f i. o p p i 0 s 

' to o o t d e v w i 11 c o n t a i n t h 0 d 0 v i c 0 n u. m to 0 r o n a 
s u c c: 0 s s t u 1 h o o t s 0 c t o r 1 o a d C S o m *© d a y. t h r 0 m a y 
be a version of the boot ROM that understands 
a b o li t h a r d d i s k s« 11 

T' f "i 0 b o o t s 0 c t o r i s 0 k 0 c: u 1 0 d « i” 8 0 0 - a 1 s o s !.... o a d 0 r 3 


D a s B o o t ’ s v 0 r s i o n n u b 0 r (t hi 0 0 c o n d w C3 r d i n t h e? R 0 li , a t 

F : ' 0002) i s -F0000.. 

B10 8 f u n c t i o n ?h. c:j n t r a p 13 s 


f un c 

li a m 0 1” s 0 0 s 6 E M D 0 8 

0 s 

[unused 3 

1 s 

[. unused 3 

2 s 

[unused 3 

’”!j u 

[unused 3 

4: 

r w a b s < r 0 a d 0 n 1 y) 

O S! 

L unused 3 

“ 

l unused 3 

/ S 

gettopto 


E x 1 0 rs c:i 0 d f u n c:: t i o n s o n t r a p 14 

f u. n c l i a m 0 L 0 0 s E x t e n d 0 d B10 8 F u n c 1 1 o n s .1 
Os [unused li 


fi t a r i C o r}::) „ C o n f i d 0 n t i a 1 







Boot 

August 26,, 

1985 


9 e r i a it Ni u rn to e r 

UOto / 


6 V 


2[unused 2 

3 s L unused 2 

4 s [unused 2 

5s [unused 2 

6s [unused 2 

7 L unused 2 

8 s t j. o p r d < r e a d s e c t o r s) 


D A S B 0 0 T u s e s m e m o r y f r o m *•£•10000 t o $20000 i o r s e r e e n 
to u t f e r s „ A v o i d 1 o a d i n q s t u. f f i n t o t h i s r e q i o n < u n t11 y o u 
t a k e o v e r t h e s y s t e m) w h e n w r i t i n g d i r e c: 11 y - to o o t a to 1 e 
ap p 1 1 c at i ons ,, 

B e t w e e n t h e t i m e w h e n D A S B 0 0 T w a s r e 1 a s e d a n d t h eo t i m e 
t h e f i r s t R A M—1 o a d e d s y s t e m s w e r e s h i p p e d < w i 11 to e 
s h i p p e d ?} t h e v a r i a to 1 e s :i. n I o w rn e rn o r y w e r e a d d e d i o a n d 

relocated„ 

< < < g i v e I i s t o f 11 s a t e * 1 v a r i a to 1 e s h e r e > > > 


Atari Corp 


Cant i dentiai 
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GEMDOS CALL 

<QUICKER) REFERENCE GUIDE 


F u n c t i o n s a r e a v a i i a b 1 e t h r o u g h t r a p # 1 « T h e f i r s t 

n u m b e r i b t h e t r a p n u rn b e r < f i r s t w o r d o n t h e s t a c k w h e n 

t h e t r a p :l. b m a d e) .. I h e t u n c: 1 i o n s n a rn e ( a s g i v e n i n 

0 8 BIN D« H) i s n e x t, a 1 o n g w i t h t h e n a rn e d a r g u rn e n t s« T h e 

n u rn b e r i n b r a c k e t s i s t h e n u m b e r o f b y t e s t h a t rn u s t b e 

c 1 a a n e d u p a f f t h e s t a c k a f t a r t h e c a 1 I i s m a d e ( f o r 

t h o s a □ f u s d o i n g t r a p s t r o rn a b b a rn b 1 y) « T' h e a r g u rn a n t 

d a c 1 a r a t i o n i. : n. (i. t a n y) f o 11 o w t h e f i r s t 1 :L n e « T h e n a 

h o r t d e s c: r i p t i o n o t t h e f : u n c t i o n i s g i v e n» 

I n g e n e r a 1 , 6 E M D 0 8 c a 11 s r e t u r n L 0 N 0 s i n D 0 „ H o m e v e r , 

t h e r e / a r e / e x c :: e p t i o n s« W h e n t e s t i n q t o r e r r o r r e t u r n s, 

i t i b b e s t t q e x a rn i n e D 0« W o n 1 y» I n a d d i t i o n , G E M D 0 S m a y 

o c: c: a b i o n a 11 y r e t u r n B 10 S b r r o r n u rn b e r s (t h a t i s n b e t w 0 e n 

-1 and . 31 )« 


0 0 P 1 0 r rn 0 () E 2 3 

T 0 r rn i n a 10 p r o c: e s s (w i t h r e t u r n c o d 0 o *f ; # 0) „ 

$01 Cconi. n <) i". 2 2 

Return cooked character from stdin„ 

'$ 0 2 C c: c:d n o u t (c h r ) L 4 3 
char chr5 

W r :i. 10 c h a r a c 10 r t o s t d o u t „ 

$03 CauxinO 1123 

R e t u. r n c: h a r a c 1 0 r -f r o rn A U X s „ 

$ 0 4 C a li x o u 1 < c h r) C 4 3 
char chr 

W r 1 1 e c h a r a c t e r t o A U X : 

$ 0 5 C p r n o 1.1 1 (c h r ) I" 4 3 
char chr; 

W r i t e c; h a r a c t e r t o P R N s 


$ 0 6 C r a w 1 o (w r d) II 4 3 
WO FLO wrd 5 

11 < w r d ::::: 0 x 0 011 > r e t u. r n c h a r f r c> rn s t d i n 

If <wrd != OxOOf-f) print it on stdout; 


A t a r i C o r p. C o n t i d 0 n t i a I 








GEHDOS 

$ 07 ' 

$08 

$09 

$0a 

$0b 

$0e 

$ 10 

$ 11 

$ 12 

$ l 3 

$ i 9 

$ 1 a 


Quickret 


August 26, 
Seri aI Number 


i 9 8 d 
006738 


7 1 


Crawci n () 21 

R e t u. r n r a. w c h a r a c: t e r f r o m s t ci i n (w i t h o u t e c h o) „ 


Cnecin() il 2 3 

R e a d c h a r f r o rn s t d i n 
c: h a r a c t e r s <* 8, ’' ‘ Q* s 
have effect« 


Cconws(str) 

1161 

char *str ; 

Wr i t e 

n u 11 -1 e r m i n a t eel 

Cconrs(but) 

1 611 

char *huf 

Read 

edited string 

bu-f CO 

1 contains size 

ex i t ? 

b u f 11 i 1 c o n t a i n s 

data 

par t of bu-f 13 

start 

s at buf 112 3 « 


Cconi s () II21 

R e t u r n •••*• 1 II n o n z e r o 11 i 
o n s t d :t n , 0 o t h e r w :t s e 


wi t h out echo u Cont r o 1 
- • C) a r e i n t e r pr e t e d a n d 


s t r i n g t o s t d o u t „ 


f r o rn s t d i n „ 0 n e n t r y , 

of data part of tauf 11 j. On 
n u m b e r o f c h a r a c: t e r s i n 
« T h e d a t a p a r t o f b u f II11 


f c h r a c t e r 1 s a v a i 1 a b i e 


0 s e t d r v C d r v) C 4 3 
WORD drv; 

8 e I e e t c u r r e n t d r :i. v e (0 - A: j. = B s H e t c: „ ) 

R e t u r n s a b :L t m a p o f d r i. v e s i n t h e s y s t e m (h i t 0 

f“i i| ii it it n } 

Cconas <) 11211 



Returns 

-1 

[nonzero 11 

i f 


consul e 

is ready to 


recei ve 

a 

character, 

0 

i f 

i t is 

"unavai 1 abl e« 15 

Cprno 

B ( ) L J 








Returns 

- 

:!. Lnonzer 

oil 

i 

f PRN s 

is ready to 


r ec: e i. ve 

a 

character, 

s’) 

i f 

:i. t i b 

"unavai 1 ab l e „ ** 

Da ux i 

s <) il 211 








Returns 

.1 

Lnonzer o IS 

i f 

c 

bar is 

avaiiabie on 


AUXs tf 0 

at 

her wi. se „ 





Da ux o 

««' •. ) L. .til .1 








Returns 

..... 

1 L' nonzero] 

i 

f AUXs 

is ready to 


recei ve 

a 

character, 

0 

1 f 

3. t. .1. B 

“unavai 1 abi e« 15 


Dgetdr v () 112II 

R e t u r n s n u m b e r o t : c u r r e n t d r i v e < 0 ™ : A r, H e t c „ ) 

F : s e t ci t a (p t r) II6 ‘J 
LONG p tr r, 

S e t d i s t r a n b f e r a d d r e s s < u s e d y F s f i r cs t < ) ) „ 


A t a r :i. C o r p „ C o n f :t ci e n t i a 1 
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$ 2 0 S u p e r (s t a c k) I" 6 3 
LONG stack; 

H a c: k p r o c e s s o r p r i v e 1 e g © rn o d e« 11 s t a c: k i s 

- 1 L , r e t u. r n 0 o r i ( p r o c: e s s o r i s i n u s © r o r 
s u p © r v i e o r rn o d e ) « 11 i n u s e r m o d e, s w x t c h t o 

s la p © r v :i. s o r m o d © a n d u s e s t a c k a s t h © s la p © r v x •••** 
s q r s t a c k (a r t h e v a I u © t r o m Li 8 P i t b 1 a c k i s 

N U L.. L..) „ I f x n s u p © r v i s o r m o d © „ s w i t c h t o la s © r 
m o d © a n d la s © s t a c k a s t h © s u p e r v x s o r s t a c: k « 
R © t la r n t h © o I d s la p © r v i s o r s t a c k v a 1 la ©» 

$ 2 a T g © t d a t © <) 2 J 

Returns dates 


b i t s 

0 n « 4 day 1«„31 

5 „ „ B month l„ w :i2 

«15 year 0 »„ 119 since 1980 


'$ 2 b T s © t d a t (d a t ©) L 4 3 
WORD dat©; 

8 e t d a t © x n t h © i' o r rn a t d © s c r i h e d a b o v © « 


2 c 1 g © 11 x rn © C) C 2 3 

Return t x rn© 


in the formats 


b x t s 
0 „ K 4 
5 . . 10 


3 e c o n d 0 n .. 5 9 C 2 ••••• s © c: o n d r e s o 1 la t x o n ) 
mi nut© 0. „59 
hour 0 « « 23 


'$ 2 d T s © 11 x rn © (t i m ©) L 4 3 
WORD txme; 

S © t t i m © x n t h © f o r rn a t d © s c: r x b © d a o v e 

'$ 2 1 F g © t t a () 12 3 

R © t u r n c u r r © n t D T A« 

i : 3 0 S v © r hb x o n () L 2 3 

R e t u r n c u r r © n t v e? r s i o n n u m h © r „ 


-$ 31 P t © r m r © bb < k © © p , r s© t) C 8 3 
LONG k©©p i 
WORD ret; 

T e r m x n a t © a n d s t a y r e s> i d e n t« k © © p h a s n u m fo © r 
o f b y t © s t a k © © p i n t In f© p r a c e^ bb s d © s c r i p t o r „ 
r © t x s t h © p r a c: e s s r e t u r n c o d © „ 


3 6 D f r ee (b u t ^ d r v) l 3 
LONG buts 
WORD drv; 


A t a r x C o r p n C o n r x d e n t x a 1 
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E 01 u. r n i n f o r m a t i o n a b o u t 
d r v (0 - c u r r 0 n t,, :L = A r, ^ 


aI location 


on 


-Bs 


etc,, ) 


dr i v© 
buf 


points to 
returned2 


a s t r u. c t u r © w h e r e s t u f t w i 11 h e 


LONG b_f reeii 
1 ... 0 N G b t o t a 1 n 

L 0 N G b.s e c s i z 

LONG? b c 1 si z ; 


# f r © e c i u s t e r s o n d r i v 0 

t o t a 1 # c: 1 u s t e r s o n d r i v © 

# b y t e s i n a s 0 c t o r 

# s e c t o r s 1 n a c 1 u s 10 r 


t 3 9 D c r 0 a t © (p a t h) E 6 3 
char *path5 

C r 0 a t e a d :i. r e c: t o r y» 

t 3 a D d © 3 . © t © (p a t h) E 6 3 
char *pathr, 

D © l © t0 a d i r e c t o r y« 


t 3 b D s © t p a t h < p a t h ) E 6 2 
char *path ; 

S © t e: u. r r © n t dir e c t o r y» 


& 3 c F c r 0 a t © (n a m © «, a 1 1 r > E 8 3 
chair *name; 

WORD attr ; 

C r © a t e a f i 1 0 w i t h t h © g i v © n p a t h n a rn ©,, R © t u r n s 
h a n d I © o r a (n © g a t i v ©) © r r o r # « B i t e*. i n t h © 
a 11 r i b u t © o r d a r © s 


t-01 
t02 
t ()4 

toe 


s © t t o r © a d 0 n i y 

h i d d © n t r o rn d i r © c: t o r y s © a r c: h 

s y s t © m t i 1 © , h i d ci © n t r o rn d 1 r 

v o i li m e I a fo © 1 (t i r s t 1 i b y t © s 


search 
o*f name) 


'$ 3 d F a p © n C n a rn © ? rn o d ©) E 8 3 
char #name; i[ 

WORD mod©; 

Open a -file. Nod© :i. s 0 , l or 2 for read, 
w r i t © ,, a n d r © a d / w r i t © „ R © t u r n s a h a n d 1 © o r a 
(n © g a t i v ©) © r !"• a r # „ 

13 © F c I o s © C h a n d I ©) E 4 2 
WORD handI 05 

Cios© th & handle» 

13f Fr©ad(handie, eount, b ut) Ei2 3 
WORD handl05 
LONG count; 
char #buf; 

R 0 a d b y t © s f r o m a t i I eR e t u r n c o u n t r © a c:i , o r 
a n © g a t i v © 0 r r o r # „ 


A t a r i C o r p „ C o n -f : i d © n t i a I 
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$ 4 0 F w r i t a (h a n d 1 a , c o u n t«, b u. f ) II i 2 J 
WORD handla; 

LONG count; 
char *buf 

W r i t e b y t e s t o a f i 1 a „ R a t u. r n c o li n t w r i 11 a n 
o r a n a g a t i v e a r r o r #» 


41 F d a I a t a (n a rn a > II6II 
char *name; 

D a I a t a t h a f i 1 a „ 


$ 4 2 F s a a k (o f f s a 1, h a n d I a , rn o d a) II1.0 li 
LONS offset; 

WORD handla; 

WORD mode; 

S a a k w i t h i n t h a f i 1 a (h a n d 1 a) . o f f s a t i s t h a 
(s i g n a d ) n u m b a r o f b y t a s t o s a a k b y« l v l o d a i s 
one ofn 


0 f r o rn b a q i n n i n g o f f i 1 e 

:l f r o rn c u r r a n t p o s x t i o n 

2 f r o m a n d o f f :i. 1 a 


$43 


Fattrib (path, mode, mode) II 10 li 

6 a t f x I a a 11 r i b u t a s i f rn o d a i s 0, 
in cd d a i s 1« B i t s ar a s 


sat them if 


#01 

readOnly 


#02 

hidden 


#04 

s y s t a in (h i d d a n 

hi ddari) 

#08 

vcd 1 urn a 1 abei 


#10 

s u h c:i x r a c 10 r y 


#20 

w r i 11 a n 10 a n d 

c1 osad 


$ 


F d u. p (s t cj h a n d i a) II 4 II 

W 0 R D s t d h a n d 1 a 5 

R a t u. r ri s n o ri ••••• s t a n d a r d h a n d i a t h a t r a f r r : r> 
same fiI a„ 


t o 


t h a 


$ 4 6 F f o r c a (s t d h a n d 1 a „ n o n s t d h a n cl l a) II6II 
W 0 R D s t d h a n d 1 a; 

W 0 R D n o n s t d h a n d 1 a n 

i ::r o r c e s t a n cl a r d h a n d i & t o o x n t t o s a m a f 11 o r 
d »a v a s- t h a n a n s t a n c.i a r d h a n d 1 a » 

$ 4 7 D g a t p* a t h (p a t h b u f „ d r v; C EJII 
c h a r * p a t h b u. f r } 

WORD drv; 

R a t u r n c: u r r e ri t d i r a c:: t c.) r y f cj r cl r x v a d r v 

(0d a f a u 11, 1 = id s , a t c « ) i. n t h a b u f f ia r » B u f f a r 

m u. s t b a a t 1 e a s t 6 4 b y t a s i o n g « 


A t a r x C o r p C o n f x cl e? n t x a J. 
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4 8 M a ]. 1 o c (a rn o u n t) 1 6 J 

LONG amount s 

a rn o u n t c: o n t a i n s # b y t e s t o a 11 o c a t e (o r 1 , 

win i ch r eturns man 1 mum avai 1 ab 1 e memor y) 

R e t u. r n p o :i. n t e r t o b 1 o c k <o n w o r d b o u n d a r y) o f 
a rn o u n t b y 10 s , o r z 0 r o o n a 11 o c a t i o n f a i 1 u r e. 

# 4 9 N t r 0 e < a d d r ) L 6II 

char *addr;; 

F r e e a b 1 o c k o t m 0 m o r y« N o n z 0 r o r e t u r n o n 

•f ai 1 ure. 

# 4 a M s h r i n k < z 0 r o , m 0 rn , s 1 z 0) II 12 II 

WORD zero5 
LONG mems 
LONG size; 

z 0 r o m u s t b 0 a w o r d c o n t a i n 1 n g 0« rn 0 rn c o n - 
t a i n s b 0 g x n n i n g o f rn 0 rn o r y b 1 o c k. ! s i z 0 ‘ i s t h 0 

t h 0 a m o u n t o f m 0 rn o r y t o R E T AIN i n t h 0 b 1 o c k „ 
N o n z 0 r o r e t u r n o n *f a i X u r 0 „ 


$ 4 b P 0 x 0 c (m o d 0, p a t h , c o m rn a n d 1 x n 0, 0 n v i r o rn 0 n t) II 16 II 
WORD mode; 
char *paths 
c: In a r * c o m m a n d 1 x n 10 s 
c h a r * 0 n v i r o rn 0 n 15 

' m o cl e 1 s o n 0 o f s 

load and go 
just X oad 
c r e a t e b a s 0 p a g 0 
just go 

c o rn rn a n d 1 x n 0 x s t h 0 c o m rn a n d t a x 1 w h x c h 1 s 
c: o p i 0 d x n t o t h 0 b a s 0 p a g e „ 0 n v i r o m 0 n t i s t h 0 

0 n v x r o rn 0 n t s t r x n g; x t N U L L.., t h 0 p a r 0 n t p r o c 0 s s 
0 n v i r o m 0 n t s t r i. n g 1 s x n h 0 i r :i. t0 d „ 

For rnod0 0, th0 r01urn cod0 x s th0 chi 1 d ' s 
r 0 1 u r n c o < j 0 , o r a n 0 g a t x v e < 0 S) 0 r r o r„ 1 1 t In 0 

1 o a d o r c r e a 10 ••••• b a s 0 p a g 0 f a i 1 s , a n 0 g a t x v 0 e r r o r 
n u m b 0 r x s r 01 u r n 0 d « 

$ 4 c P 1 0 r m <c: o d 0) II 4 II 
WORD code; 

T 0 r rn x n a 10 c: u r r 0 n t p r o c 0 s s , r 01 u r n x n g c: o d 0 t o 

the parent« 

4 0 F s t ; i. r s t < s p 0 c , a 11 r ) II8II 
char spec s 
WORD at tr i; 

a 11 r x a s 01 o t a 11 r x b u 10 s t o rn a t c h < «:•. 0 e 
•f u n c 1 1 o n # 4 3 t o r d 01 a i 1 s) , ■' s p 0 c rn a y c o n t a i n 


4 

5 


A t a r 1 C o r p „ C o n i ; x d 0 n t x a X 
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/ 6 


w i 1 d c: a r d c h a r a c: t e r s i n t h e f i 1 e n a m e , b u. t n o t i n 
t h e p a t h n a m e» R e t u r n s 0 1 1 a f i I e i s f o u n d h 
E FIL N F i t n o f i 1 e w a s t o u n d. D u. m p s s t u t f i n t a 
the DTAs 


bytes 
0 « » 20 
21 

24-25 

v ••••• y w 

30—43 


j un k 

f i 1 e a 11 r 1 b u t e? s 

i i 1 E; t i me st amp 

•f i 1 e ci a t e s t a m 

f i J. e s i z e (l a n q w o r d) 

n a m e+e k t e n s i o r? a t f o u n d t i 1 e 


'$ 4 f F s n e k t () L 2 2 

C a n t i n u e w i t h w i t h F s t i r s t () M 


$ 5 6 F r e n a m e C z e r o , o 1 d n e w) C 12 2 
WORD zero5 
char *old; 
char *new; 

C h a n g e t h e n a rn e o t a f i 1 e -f : r o m ' o 1 d t o n e w « 

■'zero' is reserved, and must be 0. 

$ 5 7 F d a 1 i m e < h a n d 1 e, b u f , s e t) II 10 3 
WORD handle; 
char *buf; 

WORD set; 

b u t p o i n t s t o b u 11 e r c o n t a i n i n g f : i 1 e c:l a t e a n d 
t i. m e i n f o r m a t i o n« J h a n d 1 e ' 1 s a h a n d 1 e t o t h e 

i i 1 e „ I f ‘ rs. ' 1 si- z e r o, get t h e 11 m e a n d d a t e« 
I f J s e t ' i. s 1 9 s e t t h e f i 1 e t :i. m e a n ci d a t e« 


A t a r i C o r p « C c:» n f : i d e n t i a 1 








